# Track accounts & videos

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

# Track accounts & videos

## Single track

`POST /api/track` with JSON:

```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
2. `active` — metrics saved
3. `error` — private post, not a video, or scraper failure
4. `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