Videos
How videos are discovered and tracked across platforms, tracking status states, stats history, and manual video management.
How videos are discovered#
Videos enter trackagoat in two ways:
Automatic discovery
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_hoursfloor).Manual add
You can add a specific video by its URL: a TikTok video/photo, or an Instagram Reel or post. 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.
Platforms#
Every video belongs to an account and carries a platform: tiktok or instagram. 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 for what's captured on Instagram.
Tracking statuses#
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 |
Reviewing videos (Tracking Inbox)#
When an account is in Selective mode, new videos land in the Tracking Inbox with pending_review status. See Inbox: approving posts for bulk-review workflows.
Video detail#
Click any video in the videos list to open the detail view:
- Stats: current view, like, comment, and share counts
- Stats history: chart of view/engagement counts over time
- Thumbnail: preview
- Notes: markdown notes for your team or agents
- Comments (paid plans): up to 100 collected comments, most liked first, with sentiment, signal filters and when they were last collected. See Comment Insights
Stats update frequency#
Video stats are refreshed on an age-based schedule (newer posts more often), and never more often than your plan's min_video_stats_hours floor allows: once a day on Free. See How scraping works. 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).
Video notes#
Like creators, every video has a notes field, the README on the video's Info tab. In the API it's the readme field. Use it to annotate videos with content classification, context, or agent instructions. If the notes change while you're editing them, saving stops and asks you to reload, and your draft is kept. The post's own text from the platform is the Caption, shown on the Info tab and returned as caption; it can't be edited.