TikTok
TikTok Top Ads

Retrieve TikTok Top Ads

Returns high-performing auction ads from TikTok Creative Center. The service defaults period to 30, page to 1, limit to 20, and order_by to for_you. Use /tiktok/top-ads/filters for dynamic enum values and static enums for order, duration, likes, and ad format.

get/tiktok/top-ads/list

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/tiktok/top-ads/list
  • Auth: API key in header x-api-key

Query parameters

period7 | 30 | 180

Lookback period in days

pageinteger

Page number

limitinteger

Maximum number of ads to return

order_by'for_you' | 'impression' | 'ctr' | 'play_2s_rate' | 'play_6s_rate' | 'cvr' | 'like'

Sort order

country_codestring

Country code or comma-separated country codes from /tiktok/top-ads/filters

keywordstring

Brand or product keyword search

industrystring

Industry filter id or comma-separated ids from /tiktok/top-ads/filters

objectivestring

Objective filter id or comma-separated ids from /tiktok/top-ads/filters

ad_languagestring

Ad language id or comma-separated ids from /tiktok/top-ads/filters

pattern_labelstring

Pattern label id or comma-separated ids from /tiktok/top-ads/filters

duration'time-2' | 'time-3' | 'time-4' | 'time-5' | 'time-6' | 'time-7'

Video duration bucket

like'1' | '2' | '3' | '4' | '5'

Like percentile bucket id or comma-separated ids

ad_format'1' | '2'

Ad format id

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.