# solari catalog instagram account history

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

- **CLI**: `solari catalog instagram account history`
- **MCP tool**: `solari_catalog_instagram_account_history`
- **Access**: `solari:read` — Available on any SOLARI plan, including the trial. One credit per successful call.
- **Plans**: Any paid plan or trial
- **Credit**: 1

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_id` (string, optional, 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)$) — Pass account_id or username.
- `username` (string, optional, ≤ 64 chars) — Instagram username. Ignored when account_id is set.
- `since` (string, optional, pattern ^\d{4}-\d{2}-\d{2}$) — First UTC date to include (YYYY-MM-DD).
- `until` (string, optional, pattern ^\d{4}-\d{2}-\d{2}$) — Last UTC date to include (YYYY-MM-DD).
- `granularity` (enum, optional, default "day") — day keeps one point per UTC day. all keeps every point. Values: `day`, `all`.

## Response

### `Response`

- `found` (boolean) — false if the account is not in the catalog.
- `account_id / username` (string) — The resolved account.
- `granularity` (string) — day or all, as applied.
- `since / until` (date) — The UTC date range covered.
- `current` (object | null) — The catalog's current values, whatever the date range.
- `points` (object[]) — Recorded values, oldest first.
- `truncated` (boolean) — true if older points were dropped. Narrow since to see them.

### `current`

- `follower_count / following_count / post_count` (integer | null) — Current counts in the catalog.
- `is_verified / is_private` (boolean | null) — Verification badge and private flag.
- `collected_at` (timestamp | null) — When the profile was last collected from Instagram.

### `points[]`

- `captured_at` (timestamp) — When SOLARI recorded these values (UTC).
- `follower_count / following_count / post_count` (integer | null) — Counts at that moment.
- `is_verified / is_private` (boolean | null) — Verification badge and private flag at that moment.

## Example

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

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "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

```json
{
  "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

- [`solari_catalog_instagram_account_profile`](https://solari.sh/docs/tools/catalog-instagram-account-profile.md)
- [`solari_catalog_instagram_content_history`](https://solari.sh/docs/tools/catalog-instagram-content-history.md)
- [`solari_fetch_instagram_account`](https://solari.sh/docs/tools/fetch-instagram-account.md)