instagram · catalog · contentsolari:read

solari catalog instagram content history

Instagram post engagement over time.

MCP tool

solari_catalog_instagram_content_history

Access

solari:read

Plans

Free Trial
Plus
Pro
Enterprise

Credit

Overview

Likes, comments, plays, and reshares of Instagram posts over time, as SOLARI recorded them. Pick posts directly, or trace an account's newest posts.

When to use it — When you want to see how a post's numbers grew, or compare posts' growth curves.

What comes back — One entry per post, each with recorded values, oldest first.

Parameters

post_idsuuid[]optional: post_ids to trace. Up to 50 together with slugs and urls.≤ 50 items, uuid
slugsstring[]optional: Instagram shortcodes to trace.≤ 50 items
urlsstring[]optional: Public Instagram post URLs to trace.≤ 50 items
account_idstringoptional: Trace this account's newest posts. Pass account_id or username.uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
usernamestringoptional: Instagram username to trace. Ignored when account_id is set.≤ 64 chars
posted_sincestringoptional: Account mode: only posts published on or after this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
posted_untilstringoptional: Account mode: only posts published on or before this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
limitintegeroptional: Account mode: how many of the newest posts to trace.default 201–50
sincestringoptional: Only values recorded on or after this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional: Only values recorded on or before this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
granularityenumoptional: day keeps one point per post per UTC day. all keeps every point.default "day"Valuesdayall

Response

foundboolean: Account mode: false if the account is not in the catalog. Post mode: false if none of the posts are.
account_id / usernamestring | null: Account mode: the resolved account.
granularitystring: day or all, as applied.
itemsobject[]: One entry per post. Request order for posts, newest first for an account.
missingstring[]: Post mode: the post_ids or shortcodes that are not in the catalog.

items[]

post_iduuid: SOLARI post id.
slugstring: Instagram shortcode.
urlstring: Public permalink.
posted_attimestamp: Published at (UTC).
account_id / usernamestring: Authoring account.
pointsobject[]: Recorded values, oldest first.
truncatedboolean: true if older points were dropped. Narrow since to see them.

items[].points[]

captured_attimestamp: When SOLARI recorded these values (UTC).
like_count / comment_countinteger | null: Likes and comments at that moment.
play_countinteger | null: Video plays at that moment. Null for images.
reshare_countinteger | null: Reshares at that moment, when Instagram shows them.
likes_hiddenboolean | null: The author hid like counts. Do not use like_count then: it is null or may not be the real count.
deletedboolean: true if the post had been deleted by then.

Example

Request

$ solari catalog instagram content history username=innisfreeofficial posted_since=2026-09-20 posted_until=2026-09-23 limit=2

Response · Long strings and repeated array entries are trimmed for readability.

{
  "found": true,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "granularity": "day",
  "items": [
    {
      "post_id": "01a0caef-bf57-7996-83af-d75cd21ab215",
      "slug": "DdlXQy8I10z",
      "url": "https://www.instagram.com/p/DdlXQy8I10z/",
      "posted_at": "2026-09-22T09:00:12Z",
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "points": [
        {
          "captured_at": "2026-09-22T21:05:04.820000Z",
          "like_count": 80,
          "comment_count": 2,
          "play_count": null,
          "reshare_count": null,
          "likes_hidden": false,
          "deleted": false
        },
        {
          "captured_at": "2026-09-23T21:30:43.016000Z",
          "like_count": 112,
          "comment_count": 3,
          "play_count": null,
          "reshare_count": null,
          "likes_hidden": false,
          "deleted": false
        },
        "… 1 more"
      ],
      "truncated": false
    },
    {
      "post_id": "01a0c433-73cd-7141-a458-e2eeb1441dba",
      "slug": "DdiychFo_91",
      "url": "https://www.instagram.com/p/DdiychFo_91/",
      "posted_at": "2026-09-21T09:00:07Z",
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "points": [
        {
          "captured_at": "2026-09-21T20:00:23.541000Z",
          "like_count": 94,
          "comment_count": 5,
          "play_count": null,
          "reshare_count": null,
          "likes_hidden": false,
          "deleted": false
        },
        {
          "captured_at": "2026-09-22T21:05:05.524000Z",
          "like_count": 114,
          "comment_count": 6,
          "play_count": null,
          "reshare_count": null,
          "likes_hidden": false,
          "deleted": false
        },
        "… 2 more"
      ],
      "truncated": false
    }
  ],
  "missing": []
}

As an MCP call

{
  "name": "solari_catalog_instagram_content_history",
  "arguments": {
    "username": "innisfreeofficial",
    "posted_since": "2026-09-20",
    "posted_until": "2026-09-23",
    "limit": 2
  }
}

Notes

Pass posts (post_ids, slugs, urls) or an account (account_id or username), not both.
since and until filter the recorded values. posted_since and posted_until pick which of the account's posts to trace.
Posts are re-collected mostly in their first days, so older posts have few points and gaps are normal.
When likes_hidden is true, do not use like_count. The author hid likes, so it is null or may not be the real count.
This reads the catalog only. For a missing post, call solari fetch instagram post url=… first. Recording starts from then; past values cannot be filled in.

Machine-readable: /docs/tools/catalog-instagram-content-history.md

Overview

Parameters

Response

Example

Notes

Related tools