curl --request GET \
  --url 'https://api.keyapi.ai/v1/tk-ads/top_ads_search?keyword=KurkurePakistan&page=1&limit=20&period=180&objective=1%2C2%2C3%2C4&ad_language=en%2Ces%2Car%2Cvi%2Cth&like=1%2C2%2C3%2C4%2C5' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

import requests

response = requests.get(
    'https://api.keyapi.ai/v1/tk-ads/top_ads_search',
    params={"keyword":"KurkurePakistan","page":1,"limit":20,"period":180,"objective":"1,2,3,4","ad_language":"en,es,ar,vi,th","like":"1,2,3,4,5"},
    headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())

const params = new URLSearchParams({"keyword":"KurkurePakistan","page":1,"limit":20,"period":180,"objective":"1,2,3,4","ad_language":"en,es,ar,vi,th","like":"1,2,3,4,5"});

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

{
  "code": 0,
  "message": "success",
  "data": {
    "materials": [
      {
        "ad_title": "Masalaydaar Tarkay, Karak Krunch Kar Ke - Sab Hogaye KrazyForKurkure!",
        "brand_name": "KurkurePakistan",
        "cost": 2,
        "ctr": 0.38,
        "favorite": false,
        "id": "7552078920880619527",
        "industry_key": "label_27101000000",
        "is_search": false,
        "like": 2152849,
        "objective_key": "campaign_objective_reach",
        "video_info": {
          "vid": "v14033g50000d93a40fog65sgujaemn0",
          "duration": 15.019,
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oYmEEquhABAgo65E41i8Am1A5BnwWA8IIafCGi~tplv-noop.image?dr=18692&refresh_token=3e3ac8cf&x-expires=1789393503&x-signature=n9fUX0u9Z5ItPNTWoXQRuRHJ14A%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v14033g50000d93a40fog65sgujaemn0",
          "video_url": {
            "1080p": "https://v16m-default.tiktokcdn.com/955090cb9c916a426c59a5a157e6e43c/6aa7fa5f/video/tos/alisg/tos-alisg-ve-0051c001-sg/oo7fIaCTDAyExHb1GII1eQ6AD1yGhLe42gIt2G/?a=0&bti=NTU4QDM1NGA%3D&&bt=3699&ft=cApXJCz7ThWH3DpDLGZmo0P&mime_type=video_mp4&rc=aGk1PDk3PDY6Mzk3M2c7NEBpM3BkeHY5cjNkPDMzODYzNEAuNDAyNjQ2XmExMzAvM2NhYSNrYmdkMmRjMTBhLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154448470D7C13C73CB14AF8F7&btag=e000b8000",
            "360p": "https://v16m-default.tiktokcdn.com/f81fd15c963706418668a20979389fea/6aa7fa5f/video/tos/alisg/tos-alisg-ve-0051c001-sg/ogABII22TDKzt61eAGCzvuKhLQ4IgEeb0Gf7D1/?a=0&bti=NTU4QDM1NGA%3D&&bt=637&ft=cApXJCz7ThWH3DpDLGZmo0P&mime_type=video_mp4&rc=NTg6NDdoZjNpM2c5ZWY1NEBpM3BkeHY5cjNkPDMzODYzNEBeXi1jMWJeNjIxYi5eNGMzYSNrYmdkMmRjMTBhLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154448470D7C13C73CB14AF8F7&btag=e000b8000",
            "480p": "https://v16m-default.tiktokcdn.com/13f109c2dfb52078173aeaaf9c9c85d5/6aa7fa5f/video/tos/alisg/tos-alisg-ve-0051c001-sg/o8BRQe6fGDHTLu2G1DIt25I0hCgE71IAexbP4A/?a=0&bti=NTU4QDM1NGA%3D&&bt=938&ft=cApXJCz7ThWH3DpDLGZmo0P&mime_type=video_mp4&rc=ZTY8aGc2OWRlN2c1ODZoNEBpM3BkeHY5cjNkPDMzODYzNEAvYi4tLWNiNmExLV9hYjY1YSNrYmdkMmRjMTBhLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154448470D7C13C73CB14AF8F7&btag=e000b8000",
            "540p": "https://v16m-default.tiktokcdn.com/00d0d1bf5360cb7555b4e373199406dc/6aa7fa5f/video/tos/alisg/tos-alisg-ve-0051c001-sg/oUEGThQe2212GC17qv4DpIWAI3g0D6CIfAeLbt/?a=0&bti=NTU4QDM1NGA%3D&&bt=1285&ft=cApXJCz7ThWH3DpDLGZmo0P&mime_type=video_mp4&rc=PDxpZzU4aWVoZWg4Omg0N0BpM3BkeHY5cjNkPDMzODYzNEAxLzFgLTYxNmAxLzNjMTAzYSNrYmdkMmRjMTBhLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154448470D7C13C73CB14AF8F7&btag=e000b8000",
            "720p": "https://v16m-default.tiktokcdn.com/822724f69c9d4e45b6faa141e0833297/6aa7fa5f/video/tos/alisg/tos-alisg-ve-0051c001-sg/oEbbPD12AeZE6Q0T12gLI4IhICfe8D0D3AGtG7/?a=0&bti=NTU4QDM1NGA%3D&&bt=1852&ft=cApXJCz7ThWH3DpDLGZmo0P&mime_type=video_mp4&rc=ZDVkZTk7Zzg3aTo5ZWVpZEBpM3BkeHY5cjNkPDMzODYzNEBfNC4uNDU1NTYxYWMuLy1jYSNrYmdkMmRjMTBhLS1kMDFzcw%3D%3D&vvpl=1&l=20260914154448470D7C13C73CB14AF8F7&btag=e000b8000"
          },
          "width": 720,
          "height": 1280
        }
      }
    ],
    "pagination": {
      "has_more": false,
      "page": 1,
      "size": 20,
      "total_count": 1
    }
  },
  "requestId": "0af59e6a-2544-45c3-898f-36b6b4985107"
}

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