How URL parsing, Apify scrapes, and pending states work.

View as Markdown

Track accounts & videos

Single track

POST /api/track with JSON:

{
  "url": "https://www.tiktok.com/@creator",
  "collection_id": "optional-uuid"
}

Returns type: "account" or type: "video" plus a job_id when a scrape is queued.

Bulk track

POST /api/track/bulk with up to 50 URLs. Each line is processed independently.

Status lifecycle

  1. pending — scrape queued / running
    1. active — metrics saved
      1. error — private post, not a video, or scraper failure
        1. paused / removed — account monitoring stopped

        Important

        • Only public data is collected
        • You never connect TikTok / Instagram / YouTube OAuth
        • Failed individual videos show an error state in the table instead of disappearing