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

solari catalog instagram account history

An Instagram account's follower and post counts over time.

MCP tool
solari_catalog_instagram_account_history
CLI
solari catalog instagram account 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

Follower, following, and post counts of an Instagram account over time, as SOLARI recorded them. Use it to chart growth or compare accounts.

When to use it — When you need follower growth or a trend, not just today's numbers.

What comes back — Recorded values, oldest first, plus the account's current values.

Parameters

account_idstringoptional
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. Ignored when account_id is set.≤ 64 chars
sincestringoptional
First UTC date to include (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional
Last UTC date to include (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
granularityenumoptional
day keeps one point per UTC day. all keeps every point.default "day"Valuesdayall

Response

Response

foundboolean
false if the account is not in the catalog.
account_id / usernamestring
The resolved account.
granularitystring
day or all, as applied.
since / untildate
The UTC date range covered.
currentobject | null
The catalog's current values, whatever the date range.
pointsobject[]
Recorded values, oldest first.
truncatedboolean
true if older points were dropped. Narrow since to see them.

current

follower_count / following_count / post_countinteger | null
Current counts in the catalog.
is_verified / is_privateboolean | null
Verification badge and private flag.
collected_attimestamp | null
When the profile was last collected from Instagram.

points[]

captured_attimestamp
When SOLARI recorded these values (UTC).
follower_count / following_count / post_countinteger | null
Counts at that moment.
is_verified / is_privateboolean | null
Verification badge and private flag at that moment.

Example

Request

$ solari catalog instagram account history username=innisfreeofficial since=2025-03-01 until=2025-03-07

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

{
  "found": true,
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "granularity": "day",
  "since": "2025-03-01",
  "until": "2025-03-07",
  "current": {
    "follower_count": 847643,
    "following_count": 17,
    "post_count": 4164,
    "is_verified": true,
    "is_private": false,
    "collected_at": "2026-09-28T05:30:38.364000Z"
  },
  "points": [
    {
      "captured_at": "2025-03-01T18:05:16.810000Z",
      "follower_count": 881841,
      "following_count": 22,
      "post_count": 3611,
      "is_verified": true,
      "is_private": false
    },
    {
      "captured_at": "2025-03-02T22:08:10.426000Z",
      "follower_count": 881784,
      "following_count": 22,
      "post_count": 3611,
      "is_verified": true,
      "is_private": false
    },
    {
      "captured_at": "2025-03-03T23:15:12.611000Z",
      "follower_count": 881711,
      "following_count": 22,
      "post_count": 3612,
      "is_verified": true,
      "is_private": false
    },
    "… 4 more"
  ],
  "truncated": false
}

As an MCP call

{
  "name": "solari_catalog_instagram_account_history",
  "arguments": {
    "username": "innisfreeofficial",
    "since": "2025-03-01",
    "until": "2025-03-07"
  }
}

Notes

  • since and until are UTC dates, and both ends are included. Without them you get the last 90 days.
  • A point exists only when SOLARI collected the account, so gaps between points are normal.
  • Most accounts have no points from late August 2025 to late September 2026. Recording resumed for most accounts on 2026-09-28.
  • Check current.collected_at before treating current as today's numbers.
  • This reads the catalog only. If the account is missing, call solari fetch instagram account username=… first. Recording starts from then; past values cannot be filled in.

Related tools

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