> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取热门广告聚集

> 从 TikTok 创意专家每月精选的精彩热门广告中汲取灵感

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">2 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`我需要调用以下 KeyAPI 接口，请根据提供的接口信息生成一份可直接运行的 Python 示例代码。

## 接口信息

Endpoint: GET https://api.keyapi.ai/v1/tk-ads/top_ads_spotlight
Summary: 获取热门广告聚集

Required Headers:
- Authorization: Bearer <YOUR_API_KEY>

Parameters:
- industry (Optional): 行业ID，（不传时不限制行业，即包含所有行业） 可选值（可多选）： 服饰鞋帽箱包=22000000000 美妆个护=14000000000 餐饮美食=27000000000 游戏=25000000000 家居家装=21000000000 手机电脑=15000000000. Example: 22000000000,14000000000,27000000000,25000000000,21000000000,15000000000
- page (Optional): 无描述. Example: 1
- limit (Optional): 每页数量. Example: 20


## 代码要求

- 使用 Python \`requests\` 库
- 提供完整、可直接运行的示例
- 处理 HTTP 请求异常、超时以及非 2xx 响应
- 处理 JSON 解析异常
- 示例参数优先使用接口信息中提供的 Example
- 保持代码简洁，避免不必要的封装和复杂设计
`)}
    >
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/tiktok-ads-library.zh.openapi.json GET /v1/tk-ads/top_ads_spotlight
openapi: 3.0.1
info:
  title: KeyAPI 文档
  description: tiktok-ads-library API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production-KeyAPI
security: []
tags: []
paths:
  /v1/tk-ads/top_ads_spotlight:
    get:
      tags: []
      summary: 获取热门广告聚集
      description: 从 TikTok 创意专家每月精选的精彩热门广告中汲取灵感
      parameters:
        - name: industry
          in: query
          description: |-
            行业ID，（不传时不限制行业，即包含所有行业）
            可选值（可多选）：
            22000000000=服饰鞋帽箱包
            14000000000=美妆个护
            27000000000=餐饮美食
            25000000000=游戏
            21000000000=家居家装
            15000000000=手机电脑
          required: false
          schema:
            type: string
            example: 22000000000,14000000000,27000000000,25000000000,21000000000
        - name: page
          in: query
          description: ''
          required: false
          example: 1
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: 每页数量
          required: false
          example: 20
          schema:
            type: integer
            default: 20
            maximum: 20
            minimum: 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  materials:
                    - cost: 2
                      ctr: 0.21
                      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:
                        vid: v10033g50000cemat43c77u2ehil0a1g
                        duration: 43.542
                        cover: >-
                          https://p16-common-sign.tiktokcdn.com/v0201/d7f3c49928d44c02a8788be62fe9487b_1672261813~tplv-noop.image?dr=18692&refresh_token=22ff4fa9&x-expires=1789393549&x-signature=p%2B3vUIfH1Jb7ov3ip1Og4BkPPrE%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v10033g50000cemat43c77u2ehil0a1g
                        video_url:
                          720p: >-
                            https://v16m-default.tiktokcdn.com/d4c36545ab1b14433a798c96707e465d/6aa7fa8d/video/tos/alisg/tos-alisg-ve-0051c001-sg/oUDqTQQgQ5AeGDK5xfNUErbM56nUBBYIggTj6S/?a=0&bti=NTU4QDM1NGA%3D&&bt=2342&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=OWc2M2g6OWlpaGVpMzQ3OUBpamRvazU6ZjdkaDMzODYzNEAyMzA0MmIwNjExMWBgLzEtYSMuLWZicjQwcWpgLS1kMC1zcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e00088000
                        width: 576
                        height: 1024
                    - cost: 2
                      ctr: 0.13
                      highlight: >-
                        Customers invest in brands based on how inclusive their
                        video ads are. In this ad we see a diversity of customer
                        groups giving their testimonies about the product.  
                      id: '7180025066401349634'
                      like: 2458
                      video_info:
                        vid: v10033g50000d8tdrinog65t107n5blg
                        duration: 28.334
                        cover: >-
                          https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oUyJbSIXHhgeGeDLJCS4ZtWHADPJt0AAqA2fd9~tplv-noop.image?dr=18692&refresh_token=7ed30dbd&x-expires=1789393534&x-signature=HoTQGE8FQIOzl7pM5v68S8tzxVA%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v10033g50000d8tdrinog65t107n5blg
                        video_url:
                          720p: >-
                            https://v16m-default.tiktokcdn.com/3ace0f15cf5d89a67ab63bbb7dc42b38/6aa7fa7e/video/tos/alisg/tos-alisg-ve-0051c001-sg/o0kAslxE2vGzYAoTwqo2kthlfBAmqQ0BHRYdDI/?a=0&bti=NTU4QDM1NGA%3D&&bt=1069&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=M2hmNGhpNzNnOTM0NGQ6O0BpamVxM3c5cmxnOzMzODYzNEA2MGMzLzVfNWIxYy5hNDYzYSNpMjQuMmRrb3FhLS1kMC1zcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e000b8000
                        width: 576
                        height: 1024
                    - cost: 2
                      ctr: 0.13
                      highlight: >-
                        By showing a real-time comparison between two products,
                        the video emphasizes the key selling points of their
                        product by showing real differences and results, which
                        is obvious and could generate the audience's interest.
                      id: '7112275044852482050'
                      like: 5580
                      video_info:
                        vid: v10033g50000capu24bc77ueem2dqo5g
                        duration: 39.149
                        cover: >-
                          https://p16-common-sign.tiktokcdn.com/v0201/c59892799ef84e029f9b45c4206cd9ab~tplv-noop.image?dr=18692&refresh_token=d66f7324&x-expires=1789393545&x-signature=uYWfAaD4bd%2FZBjX%2FsPryVnGzdW0%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v10033g50000capu24bc77ueem2dqo5g
                        video_url:
                          720p: >-
                            https://v16m-default.tiktokcdn.com/8f082e004e5bb4f3b2813fa046c5cd55/6aa7fa89/video/tos/alisg/tos-alisg-ve-0051c001-sg/oYfdQfzrNDBujEXIK7hIYCBAzQdg5OGTsitLYQ/?a=0&bti=NTU4QDM1NGA%3D&&bt=1331&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=M2VoPDY1N2Q2ZGQ8ZWhmaUBpanJncGg6Zjd4ZDMzODYzNEBjXl4tNC02XjAxMmA2MTQ2YSMybi9icjRfL21gLS1kMC1zcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e00088000
                        width: 576
                        height: 1024
                    - cost: 2
                      ctr: 0.15
                      highlight: >-
                        The video starts with a common and disturbing situation
                        where the audience could relate themselves to gain
                        attention and arouse curiosity, and then introduces the
                        product as a solution, perfectly showcasing product
                        features and applications.
                      id: '7164467399885864962'
                      like: 36951
                      video_info:
                        vid: v14033g50000d7nteivog65o65kvtj6g
                        duration: 17.904
                        cover: >-
                          https://p16-common-sign.tiktokcdn.com/tos-useast2a-p-0051c799-euttp/ocZdEUNYLDA01totO9FwBNpAzDegzBB7IPfLvE~tplv-noop.image?dr=18692&refresh_token=95360e64&x-expires=1789393524&x-signature=%2FpUtEkP7soZDbeuBjnues5WctQg%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v14033g50000d7nteivog65o65kvtj6g
                        video_url:
                          360p: >-
                            https://v16m-default.tiktokcdn.com/f9e23810f3f8022b74f966242e10961c/6aa7fa74/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/oMLDMmTFAqbXQ55GW6AeeAiMfAKg3G9CJ18ucH/?a=0&bti=NTU4QDM1NGA%3D&&bt=635&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=NzQ1OTY2N2VlNTo7NmVoNEBpam15OHI5cmx3OjMzODYzNEBiY2BhYzI0XjMxYzYtX2E2YSMzcWgzMmRzYmthLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e000b8000
                          480p: >-
                            https://v16m-default.tiktokcdn.com/85efc49d7ee7d90c7a1617cb4eaffcfd/6aa7fa74/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/ospCEBAFnIFhjNQgfcD7qTE9v51cDfRBQOApIv/?a=0&bti=NTU4QDM1NGA%3D&&bt=954&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=PDw4ZTs6M2dlZjo4NTw7NUBpam15OHI5cmx3OjMzODYzNEBiNTAtNTEwNV4xLmBeMmJjYSMzcWgzMmRzYmthLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e000b8000
                          540p: >-
                            https://v16m-default.tiktokcdn.com/6dca58ec0d65c5e506822a61099c69b4/6aa7fa74/video/tos/no1a/tos-no1a-ve-0051-no/oo6TCfsIQXeX7uuA2ATg30iMb60fMDABG8vRMo/?a=0&bti=NTU4QDM1NGA%3D&&bt=937&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=aGYzM2c4OzZmNDY6O2k2O0Bpam15OHI5cmx3OjMzODYzNEBfY14tX18vXjAxNV8uYV41YSMzcWgzMmRzYmthLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e000b8000
                          720p: >-
                            https://v16m-default.tiktokcdn.com/1cc4e45c666c2094dc4749e9fb806da8/6aa7fa74/video/tos/useast2a/tos-useast2a-ve-0051c799-euttp/o0Xf55mQvFbMAifA0CWTAqeMAJgVXDsc863G9H/?a=0&bti=NTU4QDM1NGA%3D&&bt=1357&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=aDM2ZzRpZmgzN2UzZ2lpOUBpam15OHI5cmx3OjMzODYzNEBiXzAvM2FgXjExYWFiNGFjYSMzcWgzMmRzYmthLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e000b8000
                        width: 576
                        height: 1024
                    - cost: 1
                      ctr: 0.14
                      highlight: >-
                        The video opens with an intense battle filled with the
                        sound of weapons firing and zombies yelling, pulling
                        audiences into the scene. It includes clever and fun
                        transitions in which the weapons change from rifle to
                        machine gun in sync with the rhythm of the sounds.
                      id: '7156864962475687938'
                      like: 77
                      video_info:
                        vid: v10033g50000cd94lhjc77u07fb8n53g
                        duration: 30.034
                        cover: >-
                          https://p16-common-sign.tiktokcdn.com/v0201/0ab9b32751ef469a9f01d189dd54bcd3~tplv-noop.image?dr=18692&refresh_token=fb2d3918&x-expires=1789393536&x-signature=3j8IGxJUcf%2Fb08unWOBt9ahZqNA%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v10033g50000cd94lhjc77u07fb8n53g
                        video_url:
                          720p: >-
                            https://v16m-default.tiktokcdn.com/d828d57f948f88159af260827d392ecb/6aa7fa80/video/tos/alisg/tos-alisg-ve-0051c001-sg/ooONAUDU0RdK8gQeD6rGbVgQnbAaeBgKXBdjkI/?a=0&bti=NTU4QDM1NGA%3D&&bt=2380&ft=cApXJCz7ThWHH8pDLGZmo0P&mime_type=video_mp4&rc=OTQ4NDVmZTlmZjZpPDM8NUBpajg7aTM6Zms3ZzMzODYzNEAuMDYyLzYzNWExLy1eYjUtYSMwa180cjRnaTZgLS1kMC1zcw%3D%3D&vvpl=1&l=20260914154506A71FC271E0316D7C9E4E&btag=e00088000
                        width: 576
                        height: 1024
                  pagination:
                    page: 1
                    size: 20
                    total: 5
                    has_more: false
                requestId: 2cbc70a6-1941-479b-9142-755ffeedf3be
          headers: {}
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '402':
          $ref: '#/components/responses/402'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/tk-ads/top_ads_spotlight?industry=22000000000%2C14000000000%2C27000000000%2C25000000000%2C21000000000%2C15000000000&page=1&limit=20' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/tk-ads/top_ads_spotlight',
                params={"industry":"22000000000,14000000000,27000000000,25000000000,21000000000,15000000000","page":1,"limit":20},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new
            URLSearchParams({"industry":"22000000000,14000000000,27000000000,25000000000,21000000000,15000000000","page":1,"limit":20});


            const response = await
            fetch(`https://api.keyapi.ai/v1/tk-ads/top_ads_spotlight?${params}`,
            {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            example:
              code: 400
              data: null
              message: 'Missing required parameter: handle'
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            example:
              code: 401
              data: null
              message: apiKey is null
    '402':
      description: Payment Required
      content:
        application/json:
          schema:
            type: object
            example:
              code: 402
              data: null
              message: apiKey quota is not enough
    '429':
      description: Too Many Requests
      content:
        application/json:
          schema:
            type: object
            example:
              code: 429
              data: null
              message: qps limit exceeded
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            example:
              code: 500
              data: null
              message: Internal server error
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````