# TikTok Videos Popular API (https://www.socialcrawl.dev/platforms/tiktok/videos-popular)

> Returns the videos TikTok itself ranks at the top of its Top Videos board for a market over the last 7 or 30 days, sorted by views, engagement or 6-second views. Each row is a video: `id`, `url`, the caption at `content.text`, the cover and a video file URL (signed, expires within hours), the creator at `author.username` / `author.display_name` with `ext.author_id` and `ext.author_followers`, the upload time at `published_at`, and lifetime views at `engagement.views`. What the board says about it is on `ext.trend`: `rank`, `period_views` (views inside the window), `organic_views`, `engagement_rate`, `six_second_view_through_rate` and TikTok's `content_tags`. **Markets: TikTok publishes this board for US, JP, VN, TH and ID only.** Any other market, Germany included, is refused with a 400 at no charge; for those markets use `/v1/tiktok/hashtags/popular`, which covers 27. **The board carries no like, comment or share counts and no duration**, so those leaves are null rather than estimated. It includes paid and branded posts; `organic_views` is the only paid-versus-organic signal TikTok gives. A logged-out reader of TikTok's page sees the top four, and ranks 1 to 4 were checked against it; deeper ranks follow TikTok's order as served. **Pricing is metered at 25 credits per board plus 1 credit per video returned** (20 videos = 45 credits), because each read of the board has a fixed cost. An empty board costs nothing.

TL;DR: `GET /v1/tiktok/videos/popular` costs 25 credits per board plus 1 credit per video returned. The default limit of 20 holds 45 credits and settles to the videos actually returned; an empty board costs nothing. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `countryCode` | no | Market: US, JP, VN, TH or ID, the only markets TikTok publishes this board for. Defaults to US. (US \| JP \| VN \| TH \| ID) |
| `period` | no | Window in days: 7 or 30. Defaults to 7. (7 \| 30) |
| `orderBy` | no | How TikTok ranks the board: views (the default), engagement, or six_second_views. (views \| engagement \| six_second_views) |
| `limit` | no | How many videos to return, 1-20, default 20. |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/videos/popular" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the TikTok Videos Popular API return?

Returns TikTok's Top Videos board for the US, Japan, Vietnam, Thailand or Indonesia over 7 or 30 days: each video's rank, lifetime and window views, organic views, engagement rate and creator. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the TikTok Videos Popular endpoint?

Use it for the videos TikTok ranks highest in those five markets. Other markets have no board and return a free 400; use hashtags/popular there.

### How much does the TikTok Videos Popular API cost?

The price depends on the request, from 26 to 45 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the TikTok Videos Popular API need?

No parameter is required, so the bare URL works. It also accepts 6 optional parameters, all listed on this page.

### How do I call the TikTok Videos Popular API?

Send a GET request to https://www.socialcrawl.dev/v1/tiktok/videos/popular with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl TikTok Videos Popular API return?
- How do I get TikTok Videos Popular data with the SocialCrawl API?