---
title: "Retrieve TikTok Creative Center trending videos"
method: GET
path: "/tiktok/creative-center/videos"
tags: ["TikTok", "TikTok Creative Center"]
---

# Retrieve TikTok Creative Center trending videos

`GET /tiktok/creative-center/videos`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/creative-center/videos`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `country_code` string, required
- `period` 7 | 30
- `sort_by` 'views' | 'engagement' | 'six_second_views'
- `content_label_id` string
- `content_label_ids` string[]
- `organic_only` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CreativecenterTrendingVideosResponseDoc
  - `code` integer
  - `data` CreativecenterTrendingVideosResp
    - `page_count` integer
    - `total_count` integer
    - `videos` CreativecenterTrendingVideo[]
      - `author_avatar_url` string
      - `author_bio` string
      - `author_follower_count` integer
      - `author_handle` string
      - `author_id` string
      - `author_nickname` string
      - `content_tags` CreativecenterTrendingVideoContentTag[]
        - `id` string
        - `name` string
      - `content_type` integer
      - `cover_url` string
      - `cover_urls` CreativecenterTrendingVideoCover[]
        - `format` string: Image format, for example `jpeg` or `avif`.
        - `url` string: Absolute image URL.
      - `create_time` integer
      - `creator_id` string
      - `engagement_rate` number
      - `engagement_rate_lifetime` number
      - `item_id` string
      - `organic_video_views` integer
      - `organic_video_views_lifetime` integer
      - `six_seconds_vtr` number
      - `six_seconds_vtr_lifetime` number
      - `title` string
      - `video_url` string
      - `video_views` integer
      - `video_views_lifetime` integer
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Upstream failure

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)