CaptapiCaptapi
TikTok · Guide

How to get TikTok live

TL;DR
To get TikTok live, sign up for a free Captapi key, then send one GET request to /v1/tiktok/live with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. Check whether a TikTok user is live right now — live status and basic room info when they are.
Get your free API keyAPI reference

How to get TikTok live (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the TikTok Live API

    Send an authenticated GET request to /v1/tiktok/live with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/tiktok/live?url=https%3A%2F%2Fwww.tiktok.com%2F%40khaby.lame" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "tiktok",
    "username": "espn",
    "isLive": false,
    "creator": {
      "displayName": "ESPN",
      "followers": 60012277,
      "verified": true,
      "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310257743653240837~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=80fa76fc&x-expires=1785409200&x-signature=FKUjYJgevw6H%2F02LrG5LD%2B4tMoI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
      "bio": "Serving Sports Fans. Anytime. Anywhere."
    },
    "room": {
      "id": "3578501789985538992",
      "title": "WORLD CUP FINAL PREVIEW 🏆⚽️",
      "startedAt": "2026-07-16T17:54:15.000Z",
      "viewerCount": 1,
      "totalEnterCount": 99160,
      "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310257743653240837~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=929e6963&x-expires=1785409200&x-signature=LH4jDtgdTto5OnEr2KmFkVYjrZI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
      "streamUrls": [
        "https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578501789985538992_hd.flv?expire=1786447036&sign=1d93e103fc74cb8d60ab52fbe3f75984",
        "https://pull-hls-f16-tt01.tiktokcdn-us.com/stage/stream-3578501789985538992_hd/index.m3u8?expire=1786447036&sign=c31a2a33815891e3385c09b3367fa2bc",
        "https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578501789985538992_hd/index.mpd?expire=1786447036&sign=203f24dba2b34b401151fb14a5f7dd26",
        "https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578501789985538992.flv?expire=1786447036&sign=fa936c642c249ebc46995cad6f11ce81&only_audio=1",
        "https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578501789985538992_ao/index.mpd?expire=1786447036&sign=2beb75f264b3e8a952a089b32cc47d58"
      ]
    }
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesTikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cachebooleanNoSet true to serve from the 24h response cache. Default false — always fetch fresh data.

Frequently asked questions

What does the TikTok Live API do?

The TikTok Live API lets you fetch full metadata and key stats from a public TikTok live using one GET request to /v1/tiktok/live. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the TikTok Live API cost?

Each successful call costs 1 credit. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Failed or empty results are never charged.

Do I need a TikTok API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the TikTok Live API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to get TikTok live?

Start free with 100 credits — no credit card required.

Get your free API key