TikTok Ads Get Top Ads Spotlight

2.07 credits/call
ae_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.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectNoRequest body containing optional industry, page, limit, and cookie fields to select and paginate the spotlight ad results.—
request_body.pageintegerNo页码/Page number1
request_body.limitintegerNo每页数量/Items per page20
request_body.cookiestringNo自定义Cookie字符串(可选)—
request_body.industrystringNo行业ID(可选,不传返回跨行业聚合)/Industry ID (optional)—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.