TikTok Trending Feed API

What is the TikTok Trending Feed API?

Default: TikTok For You / recommend feed with rank, publishedAt, caption (null when empty), mediaType, durationSeconds, thumbnailUrl, author{}, and engagement{}. mediaType is photo only when the canonical url contains /photo/ (or durationSeconds is null and the payload is an image post) — never because videoUrl is omitted. Session-cookie-bound web URLs (tk=tt_chain_token, or the same check hidden in a base64 policy= param) 403 for callers and are never shipped — when only those exist, videoUrl is omitted and you open the post via url; that row is still a video. author.followers is read from the feed author card when present, then hydrated from /api/user/detail for unique handles still null (8s budget). Photo rows ship images[] + imageCount (numbered-dict slides and bitrate_images included; item/detail when the feed shipped one image). videoUrlExpiresAt / thumbnailUrlExpiresAt are the split CDN windows (~36h on play URLs — the shortest in the catalogue). Envelope matches instagram/trending-reels: platform, country, countryCode, cached, source (for_you | creative_center | cache), totalReturned, requested, hasMore, nextCursor (always null — For You has no stable cursor), truncatedReason (single_page_only when the For You page filled; chart-page on a filled Creative Center page), fetchedAt, timings{path,fetchMs,hydrateMs,totalMs}. hasMore is true with nextCursor null only when truncatedReason names the cap — same rule as truth-social/user-posts. engagement always keys views/likes/comments/shares/saves/downloads plus *IsApproximate on each. Pass orderBy (hot|like|comment|repost — unknown values are 400; vv/views are aliases of hot and the response echoes hot), period (7|30|120), page, or countryCode to switch to the TikTok Creative Center popular-videos chart. A chart miss falls through to For You posts inside the period window, re-sorted by the requested metric (note says so). Hard 110s deadline. A wall with a 6h last-good page is labelled stale 200 at 0 credits; a miss with no snapshot is 502 UPSTREAM_UNAVAILABLE at 0 credits — never a billed 200 the proxy cannot deliver. country / countryCode is the chart market in Creative Center mode; on For You it is a region-availability hint. Flat 2 credits per call.

What you get

• For You richness: engagement{} + author.followers + rank
• Split videoUrlExpiresAt / thumbnailUrlExpiresAt (~36h play URLs)
• Photo carousels: images[] + imageCount
• Envelope aligned with instagram/trending-reels (hasMore / requested / truncatedReason)
• orderBy / period / countryCode / page → Creative Center chart (fallthrough re-sorted)
• Flat 2 credits

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/tiktok/trending-feed" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "platform": "tiktok",
    "country": "US",
    "countryCode": "US",
    "cached": false,
    "totalReturned": 2,
    "requested": 20,
    "hasMore": false,
    "nextCursor": null,
    "truncatedReason": null,
    "fetchedAt": "2026-08-03T11:30:00.000Z",
    "results": [
      {
        "url": "https://www.tiktok.com/@adamjones73/video/7660991836407811358",
        "id": "7660991836407811358",
        "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oERcgNIQQgASfTiefnLoipqrkyeCfiAGGKmNEI~tplv-tiktokx-origin.image?dr=9636&x-expires=1785517200&x-signature=FF%2Fhr528f3arMCaHqCr9%2BeBIue0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "author": "adamjones73",
        "authorName": "Adam",
        "views": 5400000,
        "likes": 823500,
        "comments": 4301,
        "shares": 147900,
        "rank": 1,
        "caption": "#gta #viral #fyp",
        "platform": "tiktok",
        "createTime": 1783713660,
        "publishedAt": "2026-07-10T20:01:00.000Z",
        "mediaType": "video",
        "thumbnailUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oERcgNIQQgASfTiefnLoipqrkyeCfiAGGKmNEI~tplv-tiktokx-origin.image?dr=9636&x-expires=1785517200&x-signature=FF%2Fhr528f3arMCaHqCr9%2BeBIue0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "isAd": false
      },
      {
        "url": "https://www.tiktok.com/@123court/video/7655473367125855519",
        "id": "7655473367125855519",
        "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIMffQHCCga9fWiRXUy8JOfP3WVUFGAL7oQtAQ~tplv-tiktokx-origin.image?dr=9636&x-expires=1785517200&x-signature=zF4ZAiNfBFLlLm4zu51g3NjykhI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "author": "123court",
        "authorName": "123 Court",
        "views": 3600000,
        "likes": 133800,
        "comments": 1872,
        "shares": 8999,
        "rank": 2,
        "caption": "Engaged Mom Demands More Money, But Judge Finds Out The Shocking Truth! ​#CourtroomDrama  ​#FamilyCourt  ​#ChildSupport  ​#ChildSupportCourt  ​#JudgeJules   ​#InstantKarma  ​#Backfired  ​#CaughtInTheAct  ​#PlotTwist  ​#TruckDriverLife  ​#CoParenting  ​#SplitCustody  ​#SiblingDrama  ​#RevengeBackfires",
        "platform": "tiktok",
        "createTime": 1782428791,
        "publishedAt": "2026-06-25T23:06:31.000Z",
        "mediaType": "video",
        "thumbnailUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIMffQHCCga9fWiRXUy8JOfP3WVUFGAL7oQtAQ~tplv-tiktokx-origin.image?dr=9636&x-expires=1785517200&x-signature=zF4ZAiNfBFLlLm4zu51g3NjykhI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "isAd": false
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/tiktok/trending-feed and parse the JSON response.

Use cases

Frequently asked questions

More TikTok APIs