Endpoint Playground
Test Crawlora's TikTok Creative Center Videos API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/tiktok/creative-center/videos?country_code=<country_code>&period=7&sort_by=views" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| country_code | string | Yes | ISO-2 country code | |
| period | integer | No | 7 | Lookback window in days |
| sort_by | string | No | views | Sort order |
| content_label_id | string | No | Content tag id to filter by | |
| 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",
"content_type": 1,
"create_time": 1784160116,
"content_tags": [
{
"id": "11015",
"name": "Technology & Finance"
}
],
"author_id": "7046946248401616902",
"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
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Returns TikTok Creative Center's ranked trending videos for a country, period, and sort order. 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: US, JP, ID, VN, and TH reliably return populated results; other countries have been observed to return an empty videos array (a genuine no-data response, not an error).
{
"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",
"content_type": 1,
"create_time": 1784160116,
"content_tags": [
{
"id": "11015",
"name": "Technology & Finance"
}
],
"author_id": "7046946248401616902",
"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
}
}curl "https://api.crawlora.net/api/v1/tiktok/creative-center/videos?country_code=<country_code>" \
-H "x-api-key: $CRAWLORA_API_KEY"