Unofficial TikTok API — Live Feed

Your API key — used by the Try-it console below, stored only in this browser.

GET/api/v1/live_feed

List the live streams broadcasting right now in a country, newest first and sorted by viewers. Pick a country with region and a category with category.

Parameter		Description
`region`	optional	Two-letter country code (SA, AE, EG, IQ, MA, KW, TR, US, GB, DE, FR, ...). Defaults to SA.
`category`	optional	Category name or raw channel_id: main, entertainment, variety, sports, gaming, other. Defaults to main.
`pages`	optional	How many feed pages to walk (1-5). More pages = more streams, slightly slower. Defaults to 1.
`limit`	optional	Maximum number of streams to return. Defaults to all.
`strict`	optional	true = keep only streams whose anchor is really in `region` (drops the rest).

Returns

region, category, region_supported, count, and a streams array — each with room_id, title, anchor, username, user_id, avatar_url, cover_url, viewers, likes, age_restricted, country (the anchor's real country).

Example Request

https://dev.omar-thing.site/api/v1/live_feed?region=SA&category=gaming&pages=2&limit=20&strict=true&key=YOUR_API_KEY

Example Response

{
  "data": {
    "category": "gaming",
    "count": 3,
    "region": "SA",
    "region_supported": false,
    "streams": [
      {
        "age_restricted": false,
        "anchor": "Zorro",
        "avatar_url": "https://p16-common-sign.tiktokcdn.com/.../avatar.webp",
        "country": "GB",
        "cover_url": "https://p16-common-sign.tiktokcdn.com/.../cover.jpeg",
        "likes": 125803,
        "room_id": "7689172762133613345",
        "title": "Ultimate Royal",
        "user_id": "6700000000000000000",
        "username": "zorro_xx",
        "viewers": 11066
      },
      {
        "...": "more streams",
        "anchor": "...",
        "country": "GB",
        "room_id": "..."
      }
    ]
  },
  "status": "success"
}

region optional

category optional

pages optional

limit optional

strict optional

Sends a live request using your API key above.

More Live endpoints

Unofficial TikTok Room ID API — Get a user's live room_id by username (null if they're not live right now).
Unofficial TikTok Live API — Check if a user is live and get the stream URLs (HLS + FLV) per quality.
Unofficial TikTok Last Live API — Get a user's most recent live room by username — live now OR already ended — with its stats, duration, and top_fans (top supporters by gift value).
Unofficial TikTok API — TikTok's top live-creator board for one country (~100 creators per page). Walk page to collect more.
Unofficial TikTok Live Audience API — Top viewers currently in a live stream (the online-audience ranking, by contribution). Pass a room_id from /top_live or /live_room.
Unofficial TikTok Live Chat API — Live chat & events of a LIVE room (comments, gifts, joins, likes). Pass a room_id (get one from /room_id by username). Poll with next_cursor to follow along.
Unofficial TikTok Live Chat Streaming API (SSE) — LIVE chat pushed to you over one open SSE connection instead of polling. Same events as /live_chat (comments, joins, likes, gifts). Optional alternative — /live_chat polling still works. Duplicate events are removed automatically. Auto-closes after 10 min (or 15000 events), then asks you to reconnect. Each API key may hold up to 3 live streams at once (chat+gifts).
Unofficial TikTok Live Gifts API — Gifts being sent in a LIVE room right now (sender, gift name, coins, combo). Pass a room_id (get one from /room_id by username). Poll with next_cursor.