Terms
| Term | Definition |
|---|---|
| Account | A tracked Instagram or TikTok profile, identified by its platform (instagram or tiktok) and username. See Key concepts. |
| Account video | A video discovered automatically from a tracked account’s feed. You don’t add these — they appear as the account is refreshed. Read via /v2/account-videos. See Key concepts. |
| API key | The credential you authenticate with, scoped to a single organization. Create and manage keys at API keys; see Authentication. |
| Bearer token | How you present your API key on a request: Authorization: Bearer YOUR_API_KEY. See Authentication. |
| Creator | A grouping of one or more accounts that you define — for example, one person’s Instagram and TikTok profiles. Metrics roll up from the linked accounts. See Key concepts. |
| Cursor | An opaque token that points to the next page of a collection. Pass the previous response’s next_cursor back as the cursor query param. See Pagination. |
| Engagement rate | (likes + comments + shares) / views, expressed as a percentage. One of the core analytics metrics. See Key concepts. |
| Individual video | A video you add yourself by URL, shortcode, or ID — even if you don’t track the posting account. Read and managed via /v2/videos. See Key concepts. |
| Organization | Your workspace. Every account, creator, video, API key, and metric belongs to exactly one organization, and a key only ever returns that organization’s data. See Key concepts. |
| Pagination | Walking a collection one page at a time using limit and a cursor, stopping when has_next is false. See Pagination. |
| Period / window | The span a metric is computed over — for example 7, 30, or 90 days, or a custom date range. See Key concepts. |
| Problem details (RFC 9457) | The application/problem+json error format the API returns, with type, title, status, detail, code, and instance. See Errors. |
| Rate limit | The per-key cap on how many requests you may make in a window, surfaced via X-RateLimit-* headers. See Rate limits and Limits & quotas. |
| Time series | A daily series of a metric over a window that you can chart, as opposed to a single windowed total. See Key concepts and Data freshness. |
| Tracking | Adding an account or video so CreatorAudit refreshes it on a schedule. Newly tracked resources begin populating as they’re scraped. See Data freshness. |
X-Request-ID | A correlation id returned on every response. Include it when you contact Support so we can trace the exact request. See Errors. |
Looking for the bigger picture of how accounts, creators, and videos fit together?
Start with Key concepts.