Endpoint Playground
Returns TikTok Creative Center's ranked trending videos for a country, period, sort order, and optional content tags. TikTok reports the true result-set size (see total_count/page_count in the response) but gates access to it behind a logged-in TikTok One account: an anonymous request always receives page 1 (4 videos) regardless of sort order or period. Country coverage is uneven: only US, JP, ID, VN, and TH have a regional edge host that returns populated results; other countries return an empty videos array (a genuine no-data response, not an error). See the filters endpoint for the complete country, period, sort, and content tag value lists.
14 Oct 2026: 4 videos; 20 fields had a value in every checked item and 1 varied between items.
Sample value profiles: create_time: 2026-02-19 to 2026-09-30; author_follower_count: 64,307 to 6,968,672, median 82,122; video_url: v16m-default.tiktokcdn-us.com.
curl 'https://api.crawlora.net/api/v1/tiktok/creative-center/videos?country_code=US&period=7&sort_by=views' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| country_code | string | Yes | US | ISO-2 country code |
| period | integer | No | 7 | Lookback window in days |
| sort_by | string | No | views | Sort order |
| content_label_id | string | No | Deprecated: single content tag id; use content_label_ids instead | |
| content_label_ids | array | No | Content tag ids to filter by, repeatable; matches videos carrying any selected tag | |
| organic_only | boolean | No | Restrict to organic (non-paid) videos only |
{
"code": 200,
"msg": "OK",
"data": {
"videos": [
{
"item_id": "7662909267317509407",
"title": "anyone else",
"video_url": "https://example.tiktokcdn.com/video.mp4",
"cover_url": "https://example.tiktokcdn.com/cover.jpg",
"cover_urls": [
{
"format": "jpeg",
"url": "https://example.tiktokcdn.com/cover.jpeg"
},
{
"format": "avif",
"url": "https://example.tiktokcdn.com/cover.avif"
}
],
"content_type": 1,
"create_time": 1784160116,
"content_tags": [
{
"id": "11015",
"name": "Technology & Finance"
}
],
"author_id": "7046946248401616902",
"creator_id": "103641138313531392",
"author_handle": "x.ody",
"author_nickname": "ody",
"author_avatar_url": "https://example.tiktokcdn.com/avatar.jpeg",
"author_follower_count": 787488,
"video_views": 79011161,
"video_views_lifetime": 79032186,
"organic_video_views": 11197094,
"organic_video_views_lifetime": 11218118,
"engagement_rate": 0.0101,
"engagement_rate_lifetime": 0.0101,
"six_seconds_vtr": 0.036,
"six_seconds_vtr_lifetime": 0.036
}
],
"total_count": 100,
"page_count": 25
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.