curl --request GET \
  --url 'https://api.keyapi.ai/v1/tk-ads/trends_video_list?contentLabelIDs=11003%2C11010%2C11013%2C11015&countryCode=US&page=1&limit=20&orderByMetric=1&periodDimension=1' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

import requests

response = requests.get(
    'https://api.keyapi.ai/v1/tk-ads/trends_video_list',
    params={"contentLabelIDs":"11003,11010,11013,11015","countryCode":"US","page":1,"limit":20,"orderByMetric":1,"periodDimension":1},
    headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
)
print(response.json())

const params = new URLSearchParams({"contentLabelIDs":"11003,11010,11013,11015","countryCode":"US","page":1,"limit":20,"orderByMetric":1,"periodDimension":1});

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

{
  "code": 0,
  "message": "success",
  "data": {
    "BaseResp": {
      "StatusCode": 0,
      "StatusMessage": ""
    },
    "entityInfos": [
      {
        "itemAuthorInfo": {
          "avatarURI": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/dcd32ba414395bcdd66310eea46e9625~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=5d8c0655&x-expires=1789538400&x-signature=k%2BTxIU3GsMJ0AMIQDhCw5A%2FtEsI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=429d27ce&idc=useast5",
          "bio": "Official Cardi B TikTok",
          "handlerName": "iamcardib",
          "nickName": "Cardi B"
        },
        "itemAuthorMetrics": {
          "followers": 36251099
        },
        "itemInfo": {
          "authorID": "7506219246691729454",
          "contentType": 1,
          "coverURL": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oowVAZglfAE8caCaBDRq8tBupEDSFEmO9a5I3e~tplv-tiktokx-origin.image?dr=9643&nonce=12862&refresh_token=5dfb078649dfd46356bc86829ec1fe30&x-expires=1789970400&x-signature=rTSHsbP2Gr7vTsvtZnFqPxysG4A%3D&idc=useast5&ps=13740610&shcp=89439a58&shp=c6b69ba0&t=4d5b0474",
          "coverURLList": [
            {
              "format": "avif",
              "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oowVAZglfAE8caCaBDRq8tBupEDSFEmO9a5I3e~tplv-photomode-zoomcover-tcm:720:720.avif?dr=10985&nonce=96578&refresh_token=da8006bc36fc31a94432898fc58d5e63&x-expires=1789970400&x-signature=pvwT7WjOq9V7bT4uVeoY30uU6dg%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            },
            {
              "format": "jpeg",
              "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oowVAZglfAE8caCaBDRq8tBupEDSFEmO9a5I3e~tplv-photomode-zoomcover-tcm:720:720.jpeg?dr=10985&nonce=18473&refresh_token=0a536d8929a86bf989a4cf68b4ff335b&x-expires=1789970400&x-signature=hO6NJ%2BGMiW9VhCyeCucSMGNRE%2Fg%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            }
          ],
          "createTime": 1788192479,
          "creatorID": "313520613518753792",
          "itemID": "7680228073656093966",
          "title": "Y’all know I don’t play about my @Chipotle! The official Bardi Bowl + the new Chili Lime Chips are officially in the Chipotle app. Get into it!!!!!",
          "videoURL": "https://v16m-default.tiktokcdn-us.com/32d19786c489a97635e4f9cb6428c559/6aa7ecb4/video/tos/useast5/tos-useast5-ve-0068c004-tx/osZVRauhqISWETDepBlFk2aEEwDQ9qAOAgfVx8/?a=2043&bti=NjQ7OGYwLzA6&&bt=1792&ft=GS-jnInz7ThenM0GXq8Zmo&mime_type=video_mp4&rc=Ozs2NjlpZDM6OjdlOGQ6NEBpM3MzeXg5cjN0ZDMzZzczNEAyMWM2NmAuNmExYTEtXjMzYSNrcDNyMmQ0YV5hLS1kMS9zcw%3D%3D&vvpl=1&l=20260914064503CE6F2791A467FE01D1EF&btag=e00090000"
        },
        "itemMetrics": {
          "engagementRate": 0.007564704908318182,
          "engagementRateLifeTime": 0.016369007646584974,
          "organicVideoViews": 24972103,
          "organicVideoViewsLifeTime": 44153318,
          "sixSecondsVTR": 0.07606089876520591,
          "sixSecondsVTRLifeTime": 0.12122130683119926,
          "videoViews": 81287110,
          "videoViewsLifeTime": 130633087
        }
      },
      {
        "itemAuthorInfo": {
          "avatarURI": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/1ebc50b170c461faf487dee2c69f0539~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=9e2cae41&x-expires=1789538400&x-signature=Yn7uQ9fdn2yJUZATb31tDyifc30%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=429d27ce&idc=useast5",
          "bio": "Your source for food and beverage news. 🫡\n\n📩: snachwithzach@gmail.com",
          "handlerName": "snachwithzach",
          "nickName": "snachwithzach"
        },
        "itemAuthorMetrics": {
          "followers": 581331
        },
        "itemInfo": {
          "authorID": "7219263850586079233",
          "contentType": 1,
          "coverURL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oc5EQEFltIDw21AAwmAAfQEiqqQbRTiEVADXfC~tplv-tiktokx-origin.image?dr=9643&nonce=55463&refresh_token=f8134991c392ab7a0d45422ec626644f&x-expires=1789970400&x-signature=Mcxf5OxcXOmVweN25uldUN6iWSM%3D&idc=useast5&ps=13740610&shcp=89439a58&shp=c6b69ba0&t=4d5b0474",
          "coverURLList": [
            {
              "format": "avif",
              "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oc5EQEFltIDw21AAwmAAfQEiqqQbRTiEVADXfC~tplv-photomode-zoomcover-tcm:720:720.avif?dr=10985&nonce=26320&refresh_token=c9a7352c087721abc311258001e18bf6&x-expires=1789970400&x-signature=%2BcNwqDGOuaVy7m7aI5J5rKHFel8%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            },
            {
              "format": "jpeg",
              "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oc5EQEFltIDw21AAwmAAfQEiqqQbRTiEVADXfC~tplv-photomode-zoomcover-tcm:720:720.jpeg?dr=10985&nonce=98482&refresh_token=eca269a7c5baaf152052441af524928b&x-expires=1789970400&x-signature=mpchl7lmq8ElgLrllIgICqnHyaU%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            }
          ],
          "createTime": 1788181560,
          "creatorID": "7106238330371474478",
          "itemID": "7680181143223815455",
          "title": "#ad Domino’s first-ever pizza for one just hit the menu so you know we had to try it! Feast your eyes on the Domino™, a new Detroit-style pizza with parmesan crust. Customizable how YOU want it, it’s the perfect individual meal. As a lifelong Domino’s lover, it’s everything I hoped for. Pillowy soft dough paired with a nice, crispy bite plus all of my favorite toppings. If you want my recommendation: hot sauce, chicken, banana peppers, but the best part is, the Domino™ is for you and only you, so you can personalize it just the way you’d like. You can find the new Domino™ from @Domino’s available now nationwide.  How will you build yours? #pizza #fastfood #dominos #foodtok",
          "videoURL": "https://v16m-default.tiktokcdn-us.com/2deddf8a225f1653fb3ea4192e797e7b/6aa7ec92/video/tos/useast8/tos-useast8-pve-0068-tx2/o4NECwq9QtRiEOMEFXAy3IEDVAQVlpfBdJfDzj/?a=2043&bti=NjQ7OGYwLzA6&&bt=1661&ft=GS-jnInz7ThenM0GXq8Zmo&mime_type=video_mp4&rc=NDU7OWc1ZDRpNzc1O2lnZkBpajU4Oms5cjZxZDMzaTczNEAvYS1iYV8tX2AxNTFgMGJjYSNic2hnMmRrbF5hLS1kMTJzcw%3D%3D&vvpl=1&l=20260914064503CE6F2791A467FE01D1EF&btag=e00090000"
        },
        "itemMetrics": {
          "engagementRate": 0.0018985535204178775,
          "engagementRateLifeTime": 0.0021976380986755777,
          "organicVideoViews": 9818216,
          "organicVideoViewsLifeTime": 14918857,
          "sixSecondsVTR": 0.04270707464987777,
          "sixSecondsVTRLifeTime": 0.0444946730536792,
          "videoViews": 72474649,
          "videoViewsLifeTime": 98144913
        }
      },
      {
        "itemAuthorInfo": {
          "avatarURI": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/57f759b02de679189cf842ebf9341aa7~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=50943462&x-expires=1789538400&x-signature=6YQig80S9qKk48FohUu9aq5r6BI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=429d27ce&idc=useast5",
          "bio": "Helping you start using AI to improve your life ✨\ncollabs: partnerships@marinamogilko.co",
          "handlerName": "linguamarina",
          "nickName": "Silicon Valley Girl"
        },
        "itemAuthorMetrics": {
          "followers": 3007658
        },
        "itemInfo": {
          "authorID": "6844415658239721478",
          "contentType": 1,
          "coverURL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8GJOFO5A6efHrf6dnvAAkIe7AIRQAwIDJSMEA~tplv-tiktokx-origin.image?dr=9643&nonce=45725&refresh_token=9fee52516b4706af4dfc67e35aa1718a&x-expires=1789970400&x-signature=RimLOK7EElp%2BNl8GkeeD2AS9%2Bcc%3D&idc=useast5&ps=13740610&shcp=89439a58&shp=c6b69ba0&t=4d5b0474",
          "coverURLList": [
            {
              "format": "avif",
              "imageUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8GJOFO5A6efHrf6dnvAAkIe7AIRQAwIDJSMEA~tplv-photomode-zoomcover-tcm:720:720.avif?dr=10985&nonce=59144&refresh_token=0c523074faa2e1df51b3b4918e470d53&x-expires=1789970400&x-signature=i99YTyTfGfNJiD05L9M8rpXZli0%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            },
            {
              "format": "jpeg",
              "imageUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8GJOFO5A6efHrf6dnvAAkIe7AIRQAwIDJSMEA~tplv-photomode-zoomcover-tcm:720:720.jpeg?dr=10985&nonce=21594&refresh_token=6b28c3930d0017444c7418c4e1dcfb49&x-expires=1789970400&x-signature=eSWBc5pF8Afakd4GOZzO1cL%2FfJw%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            }
          ],
          "createTime": 1778272736,
          "creatorID": "6651237571144581125",
          "itemID": "7637623185378200845",
          "title": "PDFs in 2016: you send a file. PDFs in 2026: you send an experience.  Back then it was simple - attach, send, and hope they open it. You never really knew what happened after. Did they read it? Where did they drop off? Did they even understand it?  Now this is changing. @Adobe Acrobat just introduced PDF Spaces - and it quietly fixes a very real business problem: documents that don’t convert.  Here’s what’s different:  • You don’t send separate files anymore — you build a structured flow (proposal, deck, pricing)  • You add a short audio overview → context before they even scroll  • You attach an AI assistant → it answers questions instantly, based on your doc  • You see engagement → who opened it, how far they went, if they shared it So instead of:  sending documents → chasing feedback → booking calls You get: one link → guided experience → faster decisions So instead of sending a file and chasing people after, you send one link and the whole thing explains itself. Small change, but it fixes a very common problem.  You can try it here: https://adobe.ly/MarinaPDFSpace_TT     📩 LINK IN BIO! #AdobeAcrobatPartner ",
          "videoURL": "https://v16m-default.tiktokcdn-us.com/cd06aa70128b508213421e556a1dde80/6aa7ec85/video/tos/useast5/tos-useast5-pve-0068-tx/oguJeAponvOogH25FxWQAOM1RfAGJfRRgf8cIJ/?a=2043&bti=NjQ7OGYwLzA6&&bt=1547&ft=GS-jnInz7ThenM0GXq8Zmo&mime_type=video_mp4&rc=MzY1aDM4ZjlpPGc6ODg6O0BpMzRweHA5cnA3OjMzZzczNEBfYC40LTJeX2IxL2FjYDNfYSNxYnE0MmRrZ3NhLS1kMS9zcw%3D%3D&vvpl=1&l=20260914064503CE6F2791A467FE01D1EF&btag=e00088000"
        },
        "itemMetrics": {
          "engagementRate": 0.0016449820069356776,
          "engagementRateLifeTime": 0.0020942469229396216,
          "organicVideoViews": 9056233,
          "organicVideoViewsLifeTime": 17634095,
          "sixSecondsVTR": 0.02828624067217728,
          "sixSecondsVTRLifeTime": 0.031100361034574742,
          "videoViews": 63162393,
          "videoViewsLifeTime": 137832362
        }
      },
      {
        "contentTags": [
          {
            "contentLabelID": 11004,
            "contentLabelName": "Music & Entertainment"
          }
        ],
        "itemAuthorInfo": {
          "avatarURI": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310263760982114346~tplv-tiktokx-cropcenter:300:300.jpeg?dr=9638&refresh_token=155fbbfa&x-expires=1789538400&x-signature=5fClYijrDTfnpqdFXykw7m%2FMfFE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=429d27ce&idc=useast5",
          "bio": "Let's elevate LIVE together!",
          "handlerName": "tiktoklive_us",
          "nickName": "tiktoklive_us"
        },
        "itemAuthorMetrics": {
          "followers": 2911901
        },
        "itemInfo": {
          "authorID": "7530729337490767927",
          "contentType": 1,
          "coverURL": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oAe1ewruaV0QgAI71laLNItGCFeUCgjE1VkAKH~tplv-tiktokx-origin.image?dr=9643&nonce=69606&refresh_token=58b754bff0de555620805ea7ef8f7219&x-expires=1789970400&x-signature=jTwoTkF1vuAQzl%2F78q6XiXmGP0k%3D&idc=useast5&ps=13740610&shcp=89439a58&shp=c6b69ba0&t=4d5b0474",
          "coverURLList": [
            {
              "format": "avif",
              "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oAe1ewruaV0QgAI71laLNItGCFeUCgjE1VkAKH~tplv-photomode-zoomcover-tcm:720:720.avif?dr=10985&nonce=41962&refresh_token=0cd789747cc2a7717401a5a419904106&x-expires=1789970400&x-signature=6ztt4Bv6elAf%2BFB6cFPdjXr70yw%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            },
            {
              "format": "jpeg",
              "imageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oAe1ewruaV0QgAI71laLNItGCFeUCgjE1VkAKH~tplv-photomode-zoomcover-tcm:720:720.jpeg?dr=10985&nonce=4219&refresh_token=db2360247879fa7913077f77f869aab9&x-expires=1789970400&x-signature=rEiKNCEGLBJS7fVDxV9%2BVGnQhjw%3D&idc=useast5&ps=933b5bde&shcp=89439a58&shp=c6b69ba0&t=e8257cf9"
            }
          ],
          "createTime": 1787090620,
          "creatorID": "7049832177030382598",
          "itemID": "7675495691325623566",
          "title": "Watch the Music on Stage finalists take the spotlight and showcase their talent, with special guest judge Lizzy Plapinger from All Things Go Festival! #TikTokLIVE @All Things Go ",
          "videoURL": "https://v16m-default.tiktokcdn-us.com/fbf48b8df05f0de94f58106d8732dc0a/6aa7ec68/video/tos/useast5/tos-useast5-ve-0068c002-tx/okBBRPDrhENfaHeSJmA6SD6EgKqFQEqtDIgAZY/?a=2043&bti=NjQ7OGYwLzA6&&bt=1182&ft=GS-jnInz7ThenM0GXq8Zmo&mime_type=video_mp4&rc=ODc3NDc2OWZpNzs4PDZkOUBpamY4cW85cmhnZDMzZzczNEAvLS1jMTUyXy0xNWAyMjZgYSMvYTY2MmRrYS9hLS1kMS9zcw%3D%3D&vvpl=1&l=20260914064503CE6F2791A467FE01D1EF&btag=e000b8000"
        },
        "itemMetrics": {
          "engagementRate": 0.001032681897794007,
          "engagementRateLifeTime": 0.0010553952772929022,
          "organicVideoViews": 4845807,
          "organicVideoViewsLifeTime": 13982032,
          "sixSecondsVTR": 0.0566358763145428,
          "sixSecondsVTRLifeTime": 0.048207527384849666,
          "videoViews": 35100838,
          "videoViewsLifeTime": 113643677
        }
      }
    ],
    "pagination": {
      "hasMore": true,
      "limit": 4,
      "page": 1,
      "pageCount": 25,
      "totalCount": 100
    }
  },
  "requestId": "b7293daa-f26e-4c60-b82d-a76fabad69d5"
}

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