Get regional trending video feed
GET/v1/feed/list2 Credits / video (min 10 Credits)($0.20 / 1K videos)
Fetch currently trending TikTok videos for a specific country/region (data: array of video objects with direct no-watermark URLs and full engagement statistics).
Query Parameters
regionstringrequiredTwo-letter ISO country code (
US,GB,DE,BR,JP,KR, etc.).Example:
UScountinteger (1 to 30)Number of trending videos to return.
Example:
20
Example Request (cURL / Python / JavaScript)
curl "https://api.shortvidapi.com/v1/feed/list?region=US" \
-H "x-api-key: tk_your_api_key"Live Response Preview
{
"code": 0,
"provider": "https://shortvidapi.com",
"status": "ok",
"msg": "success",
"data": [
{
"aweme_id": "",
"video_id": "7676927307113811203",
"region": "GB",
"title": "petition for more #pinkfont #relateable #fyp #foryoupage #fypシ゚ ",
"content_desc": [],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=30c22c5b&x-expires=1794841200&x-signature=DzTg%2FBFzZ4...",
"ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=30c22c5b&x-expires=1794841200&x-signature=DzTg%2FBFzZ4...",
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=30c22c5b&x-expires=1794841200&x-signature=DzTg%2FBFzZ4...",
"duration": 0,
"play": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...",
"wmplay": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...",
"size": 0,
"wm_size": 0,
"music": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...",
"music_info": {
"id": "7625347344855927574",
"title": "original sound - claudiump4",
"play": "https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e4/6af091d3/video/tos/no1a/tos-no1a-v-2370-no/oYBHoidEa6zUBn58EfVAVNK1wyilCVnMR0YNI4/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv_PD12VUW...",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/39bc0a7790233b14867a2936d5c3bae2~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=b32bee9b&x-expires=1793631600&x-signature=%2BBiXet0X4ShiA72...",
"author": "claudiump",
"original": false,
"duration": 32,
"album": ""
},
"play_count": 532054,
"digg_count": 85933,
"comment_count": 539,
"share_count": 5886,
"download_count": 58,
"collect_count": 7889,
"create_time": 1787423933,
"anchors": null,
"anchors_extras": "",
"is_ad": false,
"commerce_info": null,
"commercial_video_info": "",
"item_comment_settings": 0,
"mentioned_users": "",
"author": {
"id": "7144358461923836933",
"unique_id": "chiikawaee",
"nickname": "໒꒱",
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/5da4c559769627ad1ecd0e82fee2d9a5~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=c43d2025&x-expires=1793631600&x-signature=jFjHU3nsVEnfzrKA5Gp..."
},
"is_nff_or_nr": null,
"images": [
"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/75edbdedd62c46578e5e51858ab672ab~tplv-photomode-image-v1:q70.jpeg?dr=8793&refresh_token=8d6dc75d&x-expires=1794841200&x-signature=9iWGUuZtVBq%2Fqo2pn18%..."
]
},
{
"aweme_id": "v14044g50000dbemd9vog65h5e6sb2f0",
"video_id": "7700424018846878994",
"region": "US",
"title": "La calm",
"content_desc": [],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oIfqgLRfEvD3udLEWZFanINuB8HxQgBiWEIUVA~tplv-tiktokx-shrink_ep:640:640:q78.jpeg?dr=8592&refresh_token=dde558e6&x-expires=1793631600&x-signature=77wpIpItl7AQvltpHdx...",
"ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oIfqgLRfEvD3udLEWZFanINuB8HxQgBiWEIUVA~tplv-tiktokx-shrink_ep:640:640:q78.jpeg?dr=8592&refresh_token=dde558e6&x-expires=1793631600&x-signature=77wpIpItl7AQvltpHdx...",
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oMEF8EBLQ2RUfagn0fiVdQWuquWZxDiz3HEgAB~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=559f00b1&x-expires=1793631600&x-signature=wLero4dyREZMenkm%2...",
"duration": 15,
"play": "https://v19.tiktokcdn-us.com/d0fceae2477b530e53db22dd8175a274/6ae7ab81/video/tos/alisg/tos-alisg-pve-0037c001/owEdnVaE1xRugI3QgBFqAZfDg8UwIBUufW3ELi/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=2408&ft=aEKfuqT0mv_P...",
"wmplay": "https://v19.tiktokcdn-us.com/d0fceae2477b530e53db22dd8175a274/6ae7ab81/video/tos/alisg/tos-alisg-pve-0037c001/owEdnVaE1xRugI3QgBFqAZfDg8UwIBUufW3ELi/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=2408&ft=aEKfuqT0mv_P...",
"size": 4635726,
"wm_size": 0,
"music": "https://v19.tiktokcdn-us.com/3699917ae62bd04d163830da3ed2d155/6af091d0/video/tos/useast5/tos-useast5-v-27dcd7-tx/o4JfwM2fMYceMVCnE3WOkbTx7C83MlHQQKAVoR/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv...",
"music_info": {
"id": "7359555730812275499",
"title": "original sound - sange_singinchinese",
"play": "https://v19.tiktokcdn-us.com/3699917ae62bd04d163830da3ed2d155/6af091d0/video/tos/useast5/tos-useast5-v-27dcd7-tx/o4JfwM2fMYceMVCnE3WOkbTx7C83MlHQQKAVoR/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&&bt=125&ft=aEKfuqT0mv...",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/35891c922d019760d58068555cce2043~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=a19abc58&x-expires=1793631600&x-signature=eP%2BQLyHRu2%...",
"author": "sange",
"original": false,
"duration": 29,
"album": ""
},
"play_count": 61216129,
"digg_count": 12381003,
"comment_count": 89056,
"share_count": 2697975,
"download_count": 709,
"collect_count": 731378,
"create_time": 1792894694,
"anchors": null,
"anchors_extras": "",
"is_ad": false,
"commerce_info": null,
"commercial_video_info": "",
"item_comment_settings": 0,
"mentioned_users": "",
"author": {
"id": "6542437660387950593",
"unique_id": "rayasianboy",
"nickname": "Ray",
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/a3ad48dc1b150e483e7a278577bb16b9~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=04467c49&x-expires=1793631600&x-signature=bMVw%2F39z5ZFJNeMY9A..."
},
"is_nff_or_nr": null
}
]
}Response Fields
Success (code === 0). Charged according to the endpoint credit rate.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | Example: https://shortvidapi.com |
status | string | Example: ok |
msg | string | Example: success |
data | array of object | |
aweme_id | string | Example: |
video_id | string | Example: 7676927307113811203 |
region | string | Example: GB |
title | string | Example: petition for more #pinkfont #relateable #fyp #foryoupage #fy |
content_desc | array of string | |
cover | string | Example: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photo |
ai_dynamic_cover | string | Example: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photo |
origin_cover | string | Example: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photo |
duration | integer | Example: 0 |
play | string | Example: https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e |
wmplay | string | Example: https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e |
size | integer | Example: 0 |
wm_size | integer | Example: 0 |
music | string | Example: https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e |
music_info | object | |
id | string | Example: 7625347344855927574 |
title | string | Example: original sound - claudiump4 |
play | string | Example: https://v19.tiktokcdn-us.com/a8b634537e0b24b316a0a0348ba324e |
cover | string | Example: https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068 |
author | string | Example: claudiump |
original | boolean | Example: false |
duration | integer | Example: 32 |
album | string | Example: |
play_count | integer | Example: 532054 |
digg_count | integer | Example: 85933 |
comment_count | integer | Example: 539 |
share_count | integer | Example: 5886 |
download_count | integer | Example: 58 |
collect_count | integer | Example: 7889 |
create_time | integer | Example: 1787423933 |
anchors | string | |
anchors_extras | string | Example: |
is_ad | boolean | Example: false |
commerce_info | string | |
commercial_video_info | string | Example: |
item_comment_settings | integer | Example: 0 |
mentioned_users | string | Example: |
author | object | |
id | string | Example: 7144358461923836933 |
unique_id | string | Example: chiikawaee |
nickname | string | Example: ໒꒱ |
avatar | string | Example: https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068 |
is_nff_or_nr | string | |
images | array of string |
Status Codes
- 200
- Success (
code === 0). Charged according to the endpoint credit rate. - 400
- Invalid parameters, or API key placed in the URL query string (not charged).
- 401
- Missing or invalid
x-api-keyheader (not charged). - 402
- Insufficient credit balance (not charged).
- 403
- Account disabled (not charged).
- 404
- Unknown endpoint or disabled unstable endpoint (not charged).
- 405
- Method not allowed — all
/v1/*data endpoints useGET(not charged). - 429
- Rate limit exceeded (not charged). Respect the
Retry-Afterheader. - 503
- Temporary upstream or gateway error (not charged). Retry with exponential backoff.
Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.