Track a video
Track an individual Instagram post or TikTok video.
Set platform to "instagram" or "tiktok". The item is
registered immediately and, when added as active, its metrics are
fetched in the background so they begin populating within seconds
instead of waiting for the next refresh cycle. Subsequent refreshes
then occur automatically at the configured interval.
To track every post/video from an account automatically, add the
account via POST /accounts instead.
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 The post/video to track. Accepts a full URL (instagram.com/p/{shortcode}, tiktok.com/@user/video/{id}), a numeric id, or — for Instagram only — a bare shortcode. The server resolves and normalizes it.
1 - 512Optional key/value tags (≤20 keys, ≤255 chars each).
Track as active (default true).
Refresh cadence in hours (6–720). Defaults to 24.
6 <= x <= 720Response
Successful Response
A tracked post/video with its content fields and latest metrics.