Track an account
Add an Instagram or TikTok account for automated tracking.
Creates a tracking record scoped to your organization and begins
refreshing all of the account’s posts/videos on the configured
interval (default: every 24 hours). The account’s profile and most
recent posts/videos are fetched in the background as soon as it’s
added, so followers, totals, and recent content begin populating
within seconds instead of waiting for the first scheduled refresh.
The returned id references this account in all other endpoints.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Optional client-supplied unique key for retry-safe POSTs. Best-effort in-process dedup over a 10-minute window. Multi-replica deployments will need a shared store before this is load-bearing across all writes.
Body
Platform to track: instagram or tiktok.
instagram, tiktok Account handle to track.
1 - 128Optional creator to link this account to.
Optional category label.
128Optional key/value tags (≤20 keys, ≤255 chars each).
Refresh cadence in hours (6–720). Defaults to 24.
6 <= x <= 720Response
Successful Response
A tracked Instagram or TikTok account with its latest engagement metrics and per-account tracking configuration.