Analytics
Read post and account metrics across TikTok, Instagram, Facebook Pages and Threads.
Preview
Preview: the API and MCP server are in private beta; details may change.
Metrics are captured as periodic snapshots after a post publishes (roughly T+1 hour, T+24 hours, T+7 days, then weekly up to 90 days), and daily for account followers. Snapshots are never overwritten, so a trend can be built from the history.
Required scope: analytics:read.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /analytics/posts/{id} | Latest metric snapshot per target for one post |
| GET | /analytics/accounts/{id} | Daily follower series and summary for one account |
| GET | /analytics/summary | Totals across platforms for a profile and date range |
Request parameters
| Name | Type | Required | Description | Used by |
|---|---|---|---|---|
from | string (date) | No | Start of range | accounts, summary |
to | string (date) | No | End of range, up to 90 days | accounts, summary |
profile_id | string | Yes (summary only) | Profile to summarize | summary |
curl "https://api.getimma.com/v1/analytics/summary?profile_id=prof_01J...&from=2026-09-01&to=2026-09-30" \
-H "Authorization: Bearer imma_live_xxxxxxxxxxxxxxxxxxxx"Response (GET /analytics/posts/{id}):
{
"post_id": "post_01J...",
"targets": [
{
"target_id": "tgt_2",
"platform": "tiktok",
"captured_at": "2026-09-29T18:30:00+07:00",
"views": 12400,
"reach": null,
"likes": 980,
"comments": 34,
"shares": 12,
"saves": null
}
]
}Response (GET /analytics/summary):
{
"profile_id": "prof_01J...",
"from": "2026-09-01",
"to": "2026-09-30",
"posts_published": 24,
"total_views": 184300,
"engagement_rate": 0.041,
"follower_growth": { "count": 312, "percent": 0.028 }
}A metric that a platform does not expose is returned as null, not 0, and should be displayed as "n/a" rather than treated as zero.
Errors
| Code | HTTP | When |
|---|---|---|
unauthorized | 401 | Missing or invalid API key |
insufficient_scope | 403 | Key lacks analytics:read |
not_found | 404 | Post or account does not exist, or belongs to another workspace |
See Errors for the shared error shape.
Platform notes
Metrics availability differs per platform: TikTok, Instagram and Facebook Pages all report views, likes and comments; saves is Instagram only; reach is not available on Threads or TikTok. Metrics are only ever collected for accounts connected to your own workspace, never for other accounts, and are used solely to display back to the account owner, never sold or used to train a model. TikTok metrics collection stops (with the account's history preserved) if the account moves to needs_reconnect; see Accounts.