for agents
← All tools
instagram · catalog · accountsolari:read

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:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
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 2025-08-26 to 2025-09-27. That month was not collected and cannot be filled in.
  • 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