How videos are discovered and tracked across platforms, tracking status states, stats history, and manual video management.
Videos enter trackagoat in two ways:
The scraper periodically checks each tracked account'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 URL — a TikTok video/photo, an Instagram Reel or post, or a YouTube Short or video. Go to Project → Videos → Add video and paste the URL; the platform is detected automatically. Manually added videos are shown with the Added Manually status (stored as direct_add) and are always included in stats.
Every video belongs to an account and carries a platform — tiktok, instagram, or youtube. In the videos list and the Tracking Inbox, each video shows a small platform icon so mixed-platform projects are easy to scan, and the videos list can be filtered by platform. See Instagram tracking and YouTube tracking for what's captured on each.
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 its account is in Auto mode | ✓ Yes |
pending_review | Discovered while its account is in Selective mode | ✗ No: awaiting review |
included | Manually approved via Tracking Inbox | ✓ Yes |
excluded | Manually excluded via Tracking Inbox | ✗ No |
direct_add (shown as Added Manually) | Added by URL | ✓ Yes |
The API's /api/v2/videos endpoint never returns excluded videos. If a video is excluded, it won't appear in API responses or campaign stats.
When an account is in Selective mode, new videos land in the Tracking Inbox with pending_review status. See Tracking Inbox for bulk-review workflows.
Photo posts & carousels
TikTok photo carousels (/photo/ posts) and Instagram image posts/carousels are tracked too. They're discovered and shown alongside videos with a link to the post, and their stats are updated on a slower cadence than videos to keep collection costs down.
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 the data-freshness badge on the video header (or last_scraped_at in the API response).
You can trigger a manual stats refresh with Update Now 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 API.
