Social Fetch
Start for freeStart free
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 Failed requests are free

Try in playgroundFull API docs

About this endpoint

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. See the API docs for parameters and examples.

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