trackagoat logotrackagoat/Docs

Getting started

  • Welcome
  • Quickstart
  • Core concepts

Guides

  • Creators
  • Videos
  • Campaigns
  • Creator Goals
  • Tracking Inbox
  • Content calendar
  • How scraping works
  • Analytics & metrics
  • Similar creator pools
  • Over-posting & suppression
  • Program Health
  • Sentiment Radar
  • API keys
  • Limits & plan tiers
  • Notifications
  • Payouts

API reference

  • Overview
  • Authentication
  • Errors
  • Projects
  • Creators
  • Videos
  • Campaigns
  • Analytics
  • Aggregate Analytics
  • Payouts
  • Schema

For agents

  • Agent guide
  • Data model
  • MCP & tooling

Platform

  • Brand
  • Changelog
  • Support
DocsGuides

How scraping works

How trackagoat fetches TikTok data, what each scrape type does, when scrapes run automatically, how to trigger one manually, daily quotas, and what to do when data looks stale.

PreviousContent calendarNextAnalytics & metrics

On this page

  • Overview
  • Three scrape types
  • Automatic schedule
  • Manual scrapes ("Scrape Now")
  • Daily scrape quota
  • Viewing scrape status
  • Data freshness
  • What if a scrape fails?
  • Scraping and plan limits

Overview

trackagoat fetches TikTok data through a background scraper service. Data is not fetched in real time — it's collected on a schedule and stored so you can chart trends over time.

trackagoat is not affiliated with TikTok. Data is collected via Apify's public TikTok scraper. Stats reflect what Apify observed at scrape time and may be a few minutes to a few hours behind what you'd see on TikTok directly.

Three scrape types

TypeWhat it fetchesRuns for
Creator ProfilesFollower count, total likes, video count, bio, avatarEach tracked creator
Video StatsView, like, comment, share, and save countsEach tracked video
Discover VideosNew videos posted by tracked creators since last checkEach tracked creator

Each type runs on its own schedule and can be triggered independently.

Automatic schedule

Scrapes run automatically in the background. How often depends on your plan:

TierCreator ProfilesVideo StatsDiscover Videos
FreeEvery 24 hoursEvery 24 hoursEvery 24 hours
StarterEvery 12 hoursEvery 4 hoursEvery 12 hours
UltraEvery 6 hoursEvery 1 hourEvery 4 hours

These are the minimum intervals — your org admin can configure longer intervals, but never shorter than the tier floor. Ultra tier has no enforced floor.

Scraping starts automatically once you add a creator. You don't need to do anything to get data flowing.

Manual scrapes ("Scrape Now")

Org admins can trigger a scrape immediately without waiting for the next scheduled run. This is useful when you just added a creator and want fresh data right away, or when you know a big video just dropped.

Where to find manual triggers:

  • Creator detail page — "Scrape Now" button in the header. Scrapes that one creator's profile. The "Discover New Videos" option in the ⋯ menu runs a discovery scan for that creator specifically.
  • Video detail page → Details tab → Scrape Tier — "Scrape Now" fetches fresh stats for that single video.
  • Org Settings → Scraping tab — triggers an org-wide scrape for all creators/videos at once. Three separate buttons, one per job type.

When you click "Scrape Now", a dialog opens that:

  1. Explains what will be fetched and for whom.
  2. Shows your remaining daily quota (see below).
  3. Asks you to confirm before anything runs.

After confirming, a toast confirms the scrape started. The page data updates automatically when the job completes (usually under a minute).

Daily scrape quota

Manual scrapes count against a daily quota that resets at midnight UTC. Automated scheduled scrapes do not count against this quota — only manual "Scrape Now" triggers do.

TierManual scrapes per day
Free1
Starter10
Ultra100

What counts as one scrape trigger:

  • Clicking "Scrape Now" on a creator detail page = 1
  • Clicking "Scrape Now" on a video detail page = 1
  • Running an org-wide job type from the Scraping tab = 1 (regardless of how many creators/videos are in the org)

If you reach your daily limit, the "Scrape Now" dialog shows "Daily limit reached" and the button is disabled until midnight UTC. Your org's Usage tab (visible to admins under Org Settings) shows how many you've used today.

Viewing scrape status

Creator list — the "Last Scraped" column shows when each creator's profile was last updated.

Video list — each video shows a scrape tier badge indicating how often it's scheduled to be scraped. Hover the badge to see the next scheduled scrape time.

Video detail → Details tab → Scrape Tier — shows the tier and next scheduled scrape.

Org Settings → Scraping tab (admin only) — shows the last run time, status (OK / Partial / Failed), and processed count for each job type across the whole org.

Data freshness

Stats are snapshots, not live counters. A view count of 12,400 means that's what Apify saw the last time it scraped that video — not necessarily the current live count on TikTok.

Expected freshness by tier after a successful scrape:

  • Free: Data refreshes up to once per day.
  • Starter: Video stats can be as fresh as 4 hours old; creator profiles up to 12 hours old.
  • Ultra: Video stats up to 1 hour old; creator profiles up to 6 hours old.

Data in charts is aggregated from the stored snapshot history. If a scrape hasn't run yet for a newly added creator or video, analytics will show no data until the first scrape completes.

What if a scrape fails?

If the scraper encounters an error (TikTok rate limit, Apify outage, handle not found), the job is retried automatically with exponential backoff.

A creator or video that fails several consecutive scrapes is flagged as stale in the list view.

If you notice a creator hasn't updated in a long time, check:

1

Check the handle

Is the TikTok handle still valid? The account may have been deleted, renamed, or made private.

2

Check the Scraping tab

Is the org-wide Scraping tab showing errors? If all job types are failing, the scraper service itself may be down — contact support.

3

Try a manual scrape

Try a manual "Scrape Now" — if it succeeds, the prior failure was transient.

Scraping and plan limits

The min_*_hours scrape frequency settings are floors on scheduled scrapes — they don't limit how often you can do manual triggers (that's the max_manual_scrape_triggers_per_day quota above).

See Limits & plan tiers for all limit keys and how enforcement works.

Limits

Plan tiers and scrape frequency floors.

Program Health

Monitor scrape freshness and pipeline status.