> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatoraudit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Platforms & data coverage

> What CreatorAudit covers — Instagram and TikTok, the objects it tracks, the metrics it exposes, and what's out of scope.

CreatorAudit tracks public creator analytics on two platforms. This page sets
expectations: which platforms and objects you can work with, which metrics the API
returns, and what is intentionally out of scope.

## Platforms

CreatorAudit covers **Instagram** and **TikTok**, and only these two. Every account,
video, and creator carries a `platform` field of `instagram` or `tiktok`, and most
list endpoints accept `platform=instagram|tiktok` as a filter.

<Note>
  CreatorAudit reads **public engagement data only**. It never accesses private
  accounts, direct messages, or any non-public signal.
</Note>

## 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](/concepts) for the full model.

<Columns cols={2}>
  <Card title="Account" icon="user">
    A tracked Instagram or TikTok profile. CreatorAudit refreshes its profile metrics
    and discovers the videos in its feed.
  </Card>

  <Card title="Account video" icon="rss">
    A post discovered automatically from a tracked account's feed. You don't add these —
    they appear as the account is refreshed.
  </Card>

  <Card title="Individual video" icon="link">
    A post you add yourself by URL, shortcode, or ID — even if you don't track the
    posting account.
  </Card>

  <Card title="Creator" icon="users">
    A grouping of one or more accounts that you define, so you can analyze a person or
    brand across platforms.
  </Card>
</Columns>

An **organization** is the workspace that owns all of the above, and your API key is
scoped to a single organization. Accounts surface account videos; you group accounts
into creators; and you can track individual videos independently.

## 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. |

Creator metrics roll up from the creator's linked accounts.

<Note>
  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.
</Note>

### Verified profiles

Accounts carry an `is_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.

<Note>
  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](/data-freshness).
</Note>

## What's not available

<AccordionGroup>
  <Accordion title="No webhooks — you poll" icon="arrows-rotate">
    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](/best-practices) for polling guidance.
  </Accordion>

  <Accordion title="No private or DM data" icon="lock">
    Only public engagement metrics are collected. Private accounts, direct messages, and
    audience demographics are out of scope.
  </Accordion>

  <Accordion title="Two platforms only" icon="ban">
    Instagram and TikTok are the only supported platforms. Other networks aren't
    covered.
  </Accordion>
</AccordionGroup>

## Limits

A few practical limits shape how you read data:

* **Pagination.** List endpoints accept `limit` from `1` to `200`.
* **Search and leaderboards.** `GET /search` and `GET /creators/top` cap `limit` at
  `25`.
* **Batch metrics.** Fetch windowed metrics for many IDs in one call via
  `POST /accounts/metrics`, `POST /videos/metrics`, and
  `POST /account-videos/metrics` (up to `200` IDs each).

CreatorAudit doesn't publish numeric rate limits — read the `X-RateLimit-*` headers
at runtime. See [Rate limits](/api-reference/rate-limits) and
[Pagination](/api-reference/pagination).

## Next steps

<Columns cols={2}>
  <Card title="Key concepts" icon="diagram-project" href="/concepts">
    How accounts, creators, and videos relate.
  </Card>

  <Card title="Data freshness" icon="clock" href="/data-freshness">
    How often data refreshes and when it's ready.
  </Card>

  <Card title="Production best practices" icon="shield-check" href="/best-practices">
    Ship a reliable integration end to end.
  </Card>

  <Card title="API introduction" icon="terminal" href="/api-reference/introduction">
    Envelopes, conventions, and the endpoint reference.
  </Card>
</Columns>