TikTok
TikTok Trending feed API
To get what’s trending on TikTok in a country, call GET /v1/tiktok/get-trending-feed?region=… with your API key. You get clean JSON back.
GET
/v1/tiktok/get-trending-feedcurl "https://api.scraperize.com/v1/tiktok/get-trending-feed?region=NG" \ -H "x-api-key: YOUR_API_KEY"
Cost
1 credit / call
Only successful calls are charged. Errors are free.
Pagination
Single response
Everything comes back in one call.
Caching
0 credits
Set
cache_max_age to reuse a recent result for free.Rate limit
Per team / minute
Over the limit:
429 with a Retry-After header.Parameters
regionRequiredThe region (country) to get results for, as a two-letter code (ISO 3166-1).One of 69 values.
cache_max_ageOptionalOptional. Return a cached result if one this age or newer exists — served for 0 credits with
meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.Send your key in the x-api-key header. Full API reference
Example response
200 OK · application/json
{
"data": {
"region": "NG",
"regionName": "Nigeria",
"servedRegion": "NG",
"videos": [
{
"id": "7690672413872344340",
"url": "https://www.tiktok.com/@okotorigba_/video/7690672413872344340",
"type": "video",
"description": "my fans, make una use this one hold body. Son of God never chop since morning. #nigeriantiktok🇳🇬 #voiceover #okotorig…",
"createdAt": "2026-09-28T19:37:00.000Z",
"language": "en",
"stats": {
"playCount": 781200,
"likeCount": 144000,
"commentCount": 4698,
"shareCount": 58700,
"collectCount": 8827,
"repostCount": 0
},
"author": {
"id": "7259144692062209030",
"secUid": "MS4wLjABAAAAIHoPiDpIW_Hd51g5IQIrkvpo26eBGva_LB64M1xtmb8vL7hjos7I9kKtOQc_3eG2",
"handle": "okotorigba_",
"nickname": "okotorigba!!",
"bio": "🎭 We turn Nigerian stories into funny unfiltered animation.\nFACE REVEAL AT 100K!!!\n📧 bookings: [email protected]\n2…",
"avatarUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/e9edb9362072111a65059f9db3f745d6~tplv-tiktokx-cropcenter:1080:1…",
"verified": false,
"privateAccount": false,
"stats": {
"followerCount": 81300,
"followingCount": 11,
"likeCount": 5200000,
"videoCount": 228,
"friendCount": 0,
"diggCount": 28200
}
},
"video": {
"duration": 40,
"width": 576,
"height": 1024,
"definition": "540p",
"format": "mp4",
"codec": "h264",
"bitrate": 292448,
"quality": "lowest",
"size": 1476976,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ocBi4EJBi6A4at2EgFvtTBBAbYEIrrmw5VMdo~tplv-tiktokx-origin.image?d…",
"originCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oQQE1FqysB6nBRDDQf1JbUBgEygJauxCMtGARe~tplv-tiktokx-origin.image?…",
"dynamicCoverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oA5oYaViav8EaBEmjgBdAAIT64rBIArqBwit7~tplv-tiktokx-origin.image?d…",
"playUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oUfq6MRVEJDuR1KEggFGCQ0eBaCJIgBxsngUyA/?a=198…",
"downloadUrl": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oorDBVqLIiA6m2EtAwBihAgEEQawYHTBvo5r4/?a=1988…",
"volume": {
"loudness": -21,
"peak": 0.50119
},
"formats": [
{
"gearName": "adapt_lower_720_1",
"qualityType": 14,
"codec": "h265_hvc1",
"format": "mp4",
"bitrate": 370843,
"fps": 30,
"width": 720,
"height": 1280,
"size": 1872901,
"url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/osykoQErYmAUBEArBW6VIEKtBNv1TgiY54Bia/?a=1988…"
}
],
"subtitles": []
},
"photo": null,
"music": {
"id": "7690672464753412885",
"title": "original sound",
"url": "https://www.tiktok.com/music/original-sound-7690672464753412885",
"authorName": "okotorigba!!",
"album": null,
"duration": 40,
"preciseDuration": null,
"shootDuration": 40,
"original": true,
"isCopyrighted": false,
"isCommerceMusic": true,
"isUnlimitedMusic": false,
"isPrivate": false,
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/e9edb9362072111a65059f9db3f745d6~tplv-tiktokx-cropcenter:1080:1…",
"playUrl": "https://v16m.tiktokcdn.com/3b6b0cf381b145897fc39facac005d5a/6ac509e9/video/tos/alisg/tos-alisg-v-27dcd7/o8xprvBh6sGAi6CA…",
"streaming": []
},
"hashtags": [
{
"id": "1668565400911878",
"name": "nigeriantiktok🇳🇬",
"description": null
}
],
"mentions": [],
"effects": [
{
"id": "2559285780",
"name": "smootnes"
}
],
"stickerTexts": [],
"location": null,
"contentCategory": {
"id": 100,
"name": "Anime & Comics"
},
"anchors": [],
"warnings": [],
"playlistId": null,
"isAd": false,
"isPinned": false,
"isPrivate": false,
"isCommerce": false,
"aigcDescription": null,
"aigcLabelType": null,
"duetEnabled": true,
"stitchEnabled": true,
"shareEnabled": true,
"canRepost": true,
"commentStatus": 0,
"suggestedSearches": []
}
],
"mediaHeaders": {
"Cookie": "tt_chain_token=<session token returned by the API>",
"Referer": "https://www.tiktok.com/"
},
"count": 26,
"fetchedAt": "2026-10-05T14:46:27.327Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}A real response, shortened to one item per list.
FAQ
TikTok Trending feed API questions
How much does the TikTok Trending feed API cost?
1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.
Do I need a TikTok account or API key?
No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No TikTok login or developer app is needed.
How fresh is the data?
Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.
Where are the full parameters and response fields?
In the API reference, with every parameter, field and error.