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.tiktokapi.io/v1/feed/list?region=US" \
-H "x-api-key: tk_your_api_key"Live Response Preview
{
"code": 0,
"msg": "success",
"processed_time": 0.15,
"data": {}
}Response Fields
Success (code === 0). Charged according to the endpoint credit rate.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
msg | string | Example: success |
processed_time | number | Example: 0.15 |
data | object |
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.