# `get_audience_growth`

_Performance_

`read` `idempotent`

Follower growth and views per day (or week) for the brand's connected accounts, per account and in total. Window: `days` (7-365, default 30, ending today) or from/to (YYYY-MM-DD; from wins over days, to defaults to today, at most 365 days apart). granularity: day (default up to 90 days) or week (weeks end on `to`, so the first one can be short). History starts when the account was connected to Dalea: earlier days have followers null, and total.partial is true when an account was connected mid-window or stopped updating; an account with no snapshot inside the window is left out of the totals. Values are NET followers (gains minus losses). Days are UTC. Each point has followers, followersGained, isSnapshot (a real snapshot that day; other days are interpolated between snapshots), partial (after the last snapshot, or today), views, viewsSource, postsPublished, and for Instagram reach and accountsEngaged (daily uniques, never sum them). viewsSource account_insights is Instagram's own account-level views, which exist only for roughly the last ~35 days; derived_from_posts is the day-over-day change of the synced posts' totals, used for earlier Instagram days and for TikTok. Per account: startFollowers, endFollowers, gained (end minus start), gainedPct, avgDailyGain, views, bestDay and worstDay (largest and smallest change between consecutive daily snapshots; gapDays above 1 means the change spans missed syncs). Scraped accounts (source scrape) may stop updating. notices explains connection dates, stopped snapshots and possible account switches.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brandId` | `string` | no |  |
| `platform` | `"tiktok" \| "instagram"` | no |  |
| `days` | `integer` | no |  |
| `from` | `string` | no |  |
| `to` | `string` | no |  |
| `granularity` | `"day" \| "week"` | no |  |

## Example

### Prompt

```text
How many Instagram followers did I gain this month, and on which day did I gain the most?
```

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_audience_growth",
    "arguments": {
      "brandId": "3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f",
      "platform": "tiktok"
    }
  }
}
```

### curl

```bash
curl -X POST https://app.usedalea.ai/api/mcp/mcp \
  -H "Authorization: Bearer dalea_mcp_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_audience_growth","arguments":{"brandId":"3f6c2a4e-8b1d-4c7a-9e2f-5a1b0c9d8e7f","platform":"tiktok"}}}'
```