How TikTok videos are discovered and tracked, tracking status states, stats history, and manual video management.
Videos enter trackagoat in two ways:
The scraper periodically checks each tracked creator's recent videos and adds any new ones. Discovery frequency is set per org (subject to your plan's min_discover_videos_hours floor).
You can add a specific video by its TikTok URL. Go to Project → Videos → Add video and paste the URL. Manually added videos get status direct_add and are always included in stats.
Every video has a tracking_status that controls whether it's included in project and campaign analytics.
| Status | How it's set | Included in stats? |
|---|---|---|
auto_tracked | Discovered automatically while creator is in auto mode | ✓ Yes |
pending_review | Discovered while creator is in selective mode | ✗ No — awaiting review |
included | Manually approved via Tracking Inbox | ✓ Yes |
excluded | Manually excluded via Tracking Inbox | ✗ No |
direct_add | Added by URL | ✓ Yes |
The v1 API's /api/v1/videos endpoint never returns excluded videos. If a video is excluded, it won't appear in API responses or campaign stats.
When a creator is in selective mode, new videos land in the Tracking Inbox with pending_review status. See Tracking Inbox for bulk-review workflows.
Click any video in the videos list to open the detail view:
Stats history shows all snapshots captured since the video was added to trackagoat. It does not backfill historical data from before the video was tracked.
Video stats are refreshed on your org's min_video_stats_hours schedule. To see when a video's stats were last updated, check last_scraped_at in the video detail or API response.
You can trigger a manual stats refresh from the video detail view (subject to your plan's max_manual_scrape_triggers_per_day limit).
Like creators, every video has a notes field. This is readable via the API as the description field. Use it to annotate videos with content classification, context, or agent instructions.
API reference — Videos
Access video data programmatically via the v1 API.
