Social Fetch
Get API key
TikTok hub

TikTok trending feed API

Pull the public TikTok trending feed for a country code — structured posts, creators, and engagement in Social Fetch's shared envelope.

GET /v1/tiktok/feed/trending

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Trend monitors, creative desks, and research agents need what is rising on TikTok in a market right now, not a keyword you already guessed. Scraping the For You surface yourself means brittle clients, region quirks, and HTML that was never an API.

`GET /v1/tiktok/feed/trending` takes a required `region` (ISO 3166-1 alpha-2, such as `US` or `GB`) and returns a batch of trending posts under `data.items`. Each row has `video` (id, url, caption, createdAt, mediaType `video` or `slideshow`, isAd), optional `author`, `metrics` (views, likes, comments, shares, saves), and `media` (thumbnail and download URLs; slideshows may include `slideshowImages`). `data.totalResults` matches the length of `items`. Optional `trim=true` requests a smaller payload. There is no cursor: call again with the same region for a fresh batch that may include new and overlapping posts.

Credit pricing for this operation comes from the API registry and appears on this page; `meta.creditsCharged` is the billing source of truth. For keyword discovery use `GET /v1/tiktok/search`; for one post by URL use `GET /v1/tiktok/videos`.

TikTok trending feed API FAQ

How do I list TikTok trending posts via API?

Call GET /v1/tiktok/feed/trending with your Social Fetch API key in the x-api-key header and a required region query param (two-letter ISO country code). Optionally pass trim=true for a smaller response. Full parameters and examples are in the API docs linked from this page.

What does the TikTok trending feed response include?

data.items is the list of trending posts; data.totalResults matches that array length. Each item includes video (id, url, caption, createdAt, mediaType, isAd), author when available, metrics (views, likes, comments, shares, saves), and media URLs. The shared envelope also carries meta.requestId and meta.creditsCharged.

How does the region parameter work?

region is required and must be an ISO 3166-1 alpha-2 country code (for example US, GB, or CA). Lowercase codes are accepted and normalized. Country names like "kuwait" are rejected — pass KW instead. Keep the same region when you compare successive pulls.

How many credits does TikTok trending feed cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

Does this endpoint paginate with a cursor?

No. There is no cursor or page object. Repeat the same request (same region) for a fresh trending batch. New and overlapping posts are both possible across calls.

Is this the same as TikTok keyword search?

No. GET /v1/tiktok/feed/trending returns the regional trending feed without a search query. Keyword video search is GET /v1/tiktok/search. Hashtag search is GET /v1/tiktok/search/hashtags.

Do I need TikTok OAuth for the trending feed?

No. Authenticate to Social Fetch with an API key only. The route reads public trending posts; it does not act on behalf of a logged-in TikTok user.

Other TikTok endpoints