TikTok Trending Videos by Region API

Retrieve the TikTok trending media feed for a requested region. Pass region as a required string in /trending/{region}; the documented default and example are US. The optional custom_cursor query parameter is a string, but no example value or continuation behavior is documented. Omit it for an initial request and set it only after validating a value and its behavior for this endpoint. No response example or observed response is available for this operation. Response field names, the feed envelope, media identifiers, ranking order and continuation fields remain unverified; do not assume the global feed response contract applies here. The region selects the requested feed context, not a verified residence for creators or viewers. Supported region values beyond the documented US example are not enumerated.

API Features

Region-selected discovery Choose the requested trending feed with the region path input. US is the documented example; no complete list of supported regions is provided.

Trending carousel samples Retrieve the feed described as the main-screen trending carousel for content discovery, without treating a sample as a complete national popularity ranking.

Explicit geographic context Retain the requested region alongside each capture so comparisons describe selected feeds rather than presumed locations of creators or viewers.

Dedicated custom cursor input An optional custom_cursor string is available for this regional feed. Validate its accepted values and behavior separately from other feed endpoints.

Live API Demo

GET /api/project/tiktok/trending-media-feed-by-region

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/tiktok/trending-media-feed-by-region?key=<API_KEY>&region=US'

curl -X GET 'https://api.opendata-api.com/api/project/tiktok/trending-media-feed-by-region?key=<API_KEY>&region=US'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Prepare a US-focused creative brief from regional trending samples without presenting them as an exhaustive national ranking.
Compare matched-time captures for separately validated regions, joining video identifiers only after checking the actual response fields.
Build an editorial discovery queue tagged with the requested region and collection time for each regional feed sample.
Track whether campaign candidate videos appear in repeated samples for a selected region, without treating absence from a sample as proof of exclusion.

Frequently asked questions

How do I request the US trending feed?

Set the required region path parameter to US. US is both the documented default and example. Leave custom_cursor unset for an initial request.

Which other region values are supported?

No supported-region enumeration is documented. US is the available example; validate any additional region value before depending on it. Do not assume every country code is accepted.

How should I use custom_cursor?

It is an optional string query parameter. No sample value, continuation direction or link to a response field is documented. Omit it initially and verify its behavior for this endpoint before building pagination.

Does the region prove where creators or viewers live?

No. It identifies the requested feed context. It is not documented as evidence of a creator residence, viewer location or geographic audience breakdown.

Which response fields and ranking order are verified?

No response example or observed response is available for this regional operation. The feed container, item fields, ordering and continuation fields are unverified and should be inspected before defining a downstream schema.

Related operations

Guides

View Subscription Plans →

Get TikTok Trending Videos by Region