# 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. |

## Code example

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

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