Platforms
CreatorAudit covers Instagram and TikTok, and only these two. Every account, video, and creator carries aplatform field of instagram or tiktok, and most
list endpoints accept platform=instagram|tiktok as a filter.
CreatorAudit reads public engagement data only. It never accesses private
accounts, direct messages, or any non-public signal.
Objects
The API models a small set of objects. They map one-to-one to the dashboard, so the same concepts appear in each — see Key concepts for the full model.Account
A tracked Instagram or TikTok profile. CreatorAudit refreshes its profile metrics
and discovers the videos in its feed.
Account video
A post discovered automatically from a tracked account’s feed. You don’t add these —
they appear as the account is refreshed.
Individual video
A post you add yourself by URL, shortcode, or ID — even if you don’t track the
posting account.
Creator
A grouping of one or more accounts that you define, so you can analyze a person or
brand across platforms.
Metrics
CreatorAudit exposes the public engagement metrics below. Accounts, videos, and creators carry the subset that applies to them, and analytics responses report them over a window.| Metric | Applies to | Meaning |
|---|---|---|
| Followers | Accounts | Audience size of the profile. |
| Views | Videos | Times a video was seen. |
| Plays | Videos | Times a video was played. |
| Likes | Videos | Like reactions on a video. |
| Comments | Videos | Comments on a video. |
| Shares | Videos | Times a video was shared. |
| Saves | Videos, accounts | saved_count — Instagram only; null for TikTok. |
| Engagement rate | Videos, accounts | (likes + comments + shares) / views, as a percentage. |
Saves are returned as the
saved_count field on account and video responses, but
only for Instagram — it’s null for TikTok, which doesn’t expose saves.Verified profiles
Accounts carry anis_verified boolean reflecting the platform’s verification badge.
Use it to distinguish verified profiles when you filter or display results.
Windows and time series
You read metrics over a window —7d, 30d, or 90d, or a custom date range —
at the account, video, creator, and organization scopes. Each scope offers a single
windowed snapshot and a daily time series you can chart, and period-over-period
comparisons against the previous window.
Metrics are not real-time. A newly tracked account or video has
last_scrape_time: null until its first refresh, and its time series fills in over the following days.
Individual videos expose scrape_interval_hours to control how often they re-fetch.
See Data freshness.What’s not available
No webhooks — you poll
No webhooks — you poll
CreatorAudit does not push events. To learn when data changes, re-fetch the resource
on a sensible interval and watch
last_scrape_time. See Production best
practices for polling guidance.No private or DM data
No private or DM data
Only public engagement metrics are collected. Private accounts, direct messages, and
audience demographics are out of scope.
Two platforms only
Two platforms only
Instagram and TikTok are the only supported platforms. Other networks aren’t
covered.
Limits
A few practical limits shape how you read data:- Pagination. List endpoints accept
limitfrom1to200. - Search and leaderboards.
GET /searchandGET /creators/topcaplimitat25. - Batch metrics. Fetch windowed metrics for many IDs in one call via
POST /accounts/metrics,POST /videos/metrics, andPOST /account-videos/metrics(up to200IDs each).
X-RateLimit-* headers
at runtime. See Rate limits and
Pagination.
Next steps
Key concepts
How accounts, creators, and videos relate.
Data freshness
How often data refreshes and when it’s ready.
Production best practices
Ship a reliable integration end to end.
API introduction
Envelopes, conventions, and the endpoint reference.