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>'

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())

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);

{
  "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"
}

{
  "code": 400,
  "data": null,
  "message": "Missing required parameter: handle"
}

{
  "code": 401,
  "data": null,
  "message": "apiKey is null"
}

{
  "code": 402,
  "data": null,
  "message": "apiKey quota is not enough"
}

{
  "code": 429,
  "data": null,
  "message": "qps limit exceeded"
}

{
  "code": 500,
  "data": null,
  "message": "Internal server error"
}