> ## 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 the list of trend videos
2 creditsper request
## Copy for AI
Why Code When AI Can Do It For You?
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.
## OpenAPI
````yaml en/tiktok-ads-library.openapi.json GET /v1/tk-ads/trends_video_list
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/trends_video_list:
get:
tags: []
summary: Get the list of trend videos
parameters:
- name: contentLabelIDs
in: query
description: >-
Video content label. If omitted, no content label filter is applied
and all labels are included.
Available values (multiple selections allowed):
11002=Beauty & Care
11003=Fashion
11010=Food & Beverage
11013=Lifestyle & Leisure
11015=Technology & Finance
required: false
schema:
type: string
example: 11003,11010,11013,11015
- name: countryCode
in: query
description: 'Country code, Available values: US|JP|IV|TH|ID (default: US)'
required: false
schema:
type: string
default: US
- name: page
in: query
description: ''
required: false
schema:
type: integer
default: 1
- name: limit
in: query
description: MaxPerPage
required: false
schema:
type: integer
default: 20
maximum: 20
minimum: 1
- name: orderByMetric
in: query
description: |-
Order by, Available values:
1 = Highest video views
2 = Highest engagement
3 = Highest 6s views
required: false
schema:
type: integer
- name: periodDimension
in: query
description: 'Available values: 3=Last 7 Days, 5=Last 30 Days'
required: false
schema:
type: integer
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties: {}
example:
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. 🫡
📩: 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 ✨
collabs: 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
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/trends_video_list?contentLabelIDs=11003%2C11010%2C11013%2C11015&countryCode=US&page=1&limit=20&orderByMetric=1&periodDimension=1' \
--header 'Authorization: Bearer '
- lang: python
label: Python
source: |-
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 '}
)
print(response.json())
- lang: javascript
label: JavaScript
source: >-
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 ' }
});
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).
````