> ## 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.

# Get top ads spotlight

> Find inspiration from these standout Top Ads, handpicked by TikTok creative experts each month.

<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-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">per request</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">Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the button to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</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(`I need to call the following KeyAPI endpoint. Please generate a complete and directly runnable Python example based on the API information provided below.

## API Information

Endpoint: GET https://api.keyapi.ai/v1/tk-ads/top_ads_spotlight
Summary: Get top ads spotlight

Required Headers:
- Authorization: Bearer <YOUR_API_KEY>

Parameters:
- industry (Optional): Industry ID. If omitted, no industry filter is applied and all industries are included.
Available values (multiple selections allowed):
22000000000  = Apparel & Accessories
14000000000 = Beauty & Personal Care
27000000000 = Food & Beverage
25000000000 = Games
21000000000 = Home Improvement
15000000000 = Tech & Electronics Example: 22000000000,14000000000,27000000000,25000000000,21000000000,15000000000
- page (Optional): No description. Example: 1
- limit (Optional): MaxPerPage Example: 20


## Code Requirements

- Use the Python \`requests\` library
- Provide a complete and directly runnable example
- Handle HTTP request errors, timeouts, and non-2xx responses
- Handle JSON parsing errors
- Prefer the Example values provided in the API information for sample parameters
- Keep the code simple and avoid unnecessary abstractions or complexity
`)}
    >
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/tiktok-ads-library.openapi.json GET /v1/tk-ads/top_ads_spotlight
openapi: 3.0.1
info:
  title: Tiktok-ads API english documentation
  description: >-
    The english reference documentation of the Tiktok-ads API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  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: Get top ads spotlight
      description: >-
        Find inspiration from these standout Top Ads, handpicked by TikTok
        creative experts each month.
      parameters:
        - name: industry
          in: query
          description: >-
            Industry ID. If omitted, no industry filter is applied and all
            industries are included.

            Available values (multiple selections allowed):

            22000000000  = Apparel & Accessories

            14000000000 = Beauty & Personal Care

            27000000000 = Food & Beverage

            25000000000 = Games

            21000000000 = Home Improvement

            15000000000 = Tech & Electronics
          required: false
          schema:
            type: string
            example: >-
              22000000000,14000000000,27000000000,25000000000,21000000000,15000000000
        - name: page
          in: query
          description: ''
          required: false
          example: 1
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: MaxPerPage
          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: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````