TikTok
TikTok Creative Center

Retrieve TikTok Creative Center trending videos

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.

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

Query parameters

country_codestring required

ISO-2 country code

period7 | 30

Lookback window in days

sort_by'views' | 'engagement' | 'six_second_views'

Sort order

content_label_idstring

Deprecated: single content tag id; use content_label_ids instead

content_label_idsstring[]

Content tag ids to filter by, repeatable; matches videos carrying any selected tag

organic_onlyboolean

Restrict to organic (non-paid) videos only

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.