TikTok Ads Get Top Ads Spotlight
Retrieve a paginated spotlight list of popular advertisements for creative research and trend analysis. Optionally provide an industry ID to focus the results; omit it for a cross-industry aggregate list. You can also set the page number and page size, while the optional cookie field allows a custom cookie string. Results include ad materials with cost level, click-through rate, highlights, ad and like identifiers, video metadata, playback URLs in several qualities, dimensions, and pagination information. If a filtered request returns no results, try adjusting or removing the filter.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | No | Request body containing optional industry, page, limit, and cookie fields to select and paginate the spotlight ad results. | — |
request_body.page | integer | No | 页码/Page number | 1 |
request_body.limit | integer | No | 每页数量/Items per page | 20 |
request_body.cookie | string | No | 自定义Cookie字符串(可选) | — |
request_body.industry | string | No | 行业ID(可选,不传返回跨行业聚合)/Industry ID (optional) | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_ads_get_top_ads_spotlight' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"limit": 8,
"page": 1
}
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"materials": [
{
"cost": 2,
"ctr": 0.22,
"highlight": "Showcase a real-time comparison between products, while communicating your product's value and superiority. Leverage your product's unique features to encourage a purchase.",
"id": "7182310470102122497",
"like": 33506,
"video_info": {
"cover": "https://p19-common-sign.tiktokcdn.com/v0201/d7f3c49928d44c02a8788be62fe9487b_1672261813~tplv-noop.image?dr=18692&refresh_token=[REDACTED]&x-expires=1794381903&x-signature=[REDACTED]&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v10033g50",
"duration": 43.542,
"height": 1024,
"vid": "v10033g50000cemat43c77u2ehil0a1g",
"video_url": {},
"width": 576
}
}
],
"pagination": {
"has_more": false,
"page": 1,
"size": 8,
"total": 5
}
},
"msg": "OK"
},
"docs": "https://api.tikhub.io/#/TikTok-Ads-API/get_top_ads_spotlight_api_v1_tiktok_ads_get_top_ads_spotlight_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {}
}This example shows part of the response. Copied content is valid JSON.

