for agents
← All tools
instagram · catalog · contentsolari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.

solari catalog instagram content history

Instagram post engagement over time.

MCP tool
solari_catalog_instagram_content_history
CLI
solari catalog instagram content history
Access
solari:readAvailable on any SOLARI plan, including the trial. One credit per successful call.Available on any SOLARI plan, including the trial. One credit per successful call.
Plans
Any paid plan or trial
Credit
1

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.≥ 1
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

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 and view counts. like_count is usually still there.
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.
  • likes_hidden=true does not mean like_count is missing. It is usually still there, so keep those posts in comparisons.
  • 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.

Related tools

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