# TikTok Trending API (https://www.socialcrawl.dev/platforms/tiktok/trending) > Returns a page of popular TikTok videos for a country, with view, like, comment, share and save counts, caption, author and thumbnail. Two feeds, chosen with `feed`. The default (`feed=global`) is TikTok's web trending feed fetched through a connection in `region`: `region` sets where the request comes from, not where the videos come from, and for most countries the feed is one worldwide pool. Measured 13/09/2026 over 12 calls in six countries, 22% of its videos were registered in the requested country (US 65%, BR 43%, GB 9%, FR 8%, JP 6%, DE 0%). It returns about 13 videos in 3 to 12 seconds. `feed=local` is the For You feed TikTok's app serves to a phone set to `region`, so most, not all, of its videos are from that country: 57% of videos on 10 served pages the same day (DE 52%, US 66%, GB 41%, JP 81%), and 51% were captioned in the country's main language. It returns a median of 24 videos (13 to 33 on 9 pages in 10), and 9 calls in 10 answer within 22 seconds (364 served pages, 18-19/10/2026). On about 1 local call in 11 (26 of 281 measured 14-17/10/2026) the supplier is throttled or times out and no video comes back: that returns 503 with credits refunded, and a retry a minute later usually succeeds. A local request never falls back to the global feed. Both feeds cost the same, carry no cursor, and return each video once. Every row carries `ext.region`, the country the video is registered to, so filter on it when you need only that country; local rows also carry `ext.content_language`, TikTok's own caption-language tag. `post.ext.matched_song_id` is the catalogue song TikTok matched the row's sound to, present when it made a match: an official clip and the original sounds creators upload with it have different `post.ext.music_id` values and one `matched_song_id`, so group on it to count a song's uses (it is not a clipId for `/v1/tiktok/song/videos`). TL;DR: `GET /v1/tiktok/trending` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `region` | yes | ISO 3166-1 alpha-2 country code (e.g., US, GB, DE). On the default feed it sets the country the request is routed through and does not filter videos; with `feed=local` it sets the country the For You feed is built for. Either way, check `ext.region` on each row for the country a video is actually from. | | `trim` | no | Accepted for compatibility; it has no effect with `feed=local`. | | `feed` | no | `global` (default): the web trending feed routed through `region`, mostly worldwide content, about 13 videos in 3 to 12 seconds. `local`: the For You feed for a phone in `region`, most videos from that country, a median of 24 videos with 9 calls in 10 answering within 22 seconds, and a refunded 503 when none come back. (global \| local) | | `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. | | `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/tiktok/trending" \ --data-urlencode "region=US" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### How do I get the TikTok trending feed with an API? Send a GET request to /v1/tiktok/trending with region set to a two-letter country code such as US, GB or DE. By default you get TikTok's web trending feed routed through that country, which for most countries is one worldwide pool. Add feed=local for the For You feed TikTok serves a phone in that country: in a 13/09/2026 test, 57% of its videos were from the requested country. ### What data does the TikTok Trending endpoint return? Each trending video includes video id, url, caption, view count, like count, comment count, share count, thumbnail URL, creation timestamp, full creator details, and the country the video is registered to (post.ext.region). Local feed rows also carry TikTok's caption-language tag (post.ext.content_language). ### Does region return only videos from that country? No, region never filters. On the default feed it sets the country the request is routed through, and in a six-country test on 13/09/2026 only 22% of videos matched it (US 65%, DE 0%). With feed=local most videos come from that country (DE 52%, US 66%, JP 81%), but not all. To keep one country's videos only, filter the rows on post.ext.region. ### How fresh is the TikTok trending feed? Each call reflects the feed at the moment of the request, and a repeat call returns a different set. Responses are cached for two minutes, so back-to-back identical requests return quickly without extra credits. The default feed answers in 3 to 12 seconds; a local feed call takes 12 to 35 seconds. ### How much does the TikTok Trending API cost? Each request costs 5 credits on the advanced tier because trending feeds require heavier upstream work. New accounts get 100 free credits with no credit card required. See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - How to get the TikTok trending feed with the SocialCrawl API - What does the SocialCrawl TikTok Trending endpoint return?