---
title: "TikTok Live Info API"
method: GET
path: "/v1/tiktok/live-info"
tags: ["TikTok"]
---

# TikTok Live Info API

`GET /v1/tiktok/live-info`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/tiktok/live-info`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Identical to TikTok Live (isLive, creator.id/secUid, streamQualities hls/cmaf).

True alias of GET /v1/tiktok/live — same runner, same JSON (isLive/status, creator.id/secUid, room.streamQualities with flv/hls/cmaf/dash when TikTok exposes them). Own billing/cache key only. Flat 1 credit, same as /live.

Docs: https://captapi.com/apis/tiktok-live-info

## Query parameters

- `url` string, required
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Platform identifier for this response (matches the endpoint's platform).
    - `username` string: Account username / handle.
    - `isLive` boolean: true only when status === 2 — a non-empty room payload does not mean the creator is live.
    - `status` integer: TikTok liveRoom/user status enum. 2 = currently live (isLive true). Other codes (commonly 4) mean the last room payload is ended/stale — still may include title, enter counts, and pull URLs.
    - `creator` object
      - `id` string: Id of this creator item.
      - `secUid` string: TikTok secure user ID — required for many platform-internal list endpoints.
      - `displayName` string: Display name of the account. Canonical across profile endpoints (prefer over name).
      - `followers` integer: Follower count.
      - `following` integer: Number of accounts followed.
      - `verified` boolean: Whether the account is verified on this platform.
      - `avatar` string: Avatar / profile picture URL. Canonical across profile endpoints.
      - `bio` string: Profile bio. Canonical across profile endpoints (prefer over description on YouTube).
      - `status` integer: TikTok liveRoom/user status enum. 2 = currently live (isLive true). Other codes (commonly 4) mean the last room payload is ended/stale — still may include title, enter counts, and pull URLs.
    - `room` object
      - `id` string: Id of this room item.
      - `streamId` string: TikTok live stream id (distinct from room id when both exist).
      - `status` integer: TikTok liveRoom/user status enum. 2 = currently live (isLive true). Other codes (commonly 4) mean the last room payload is ended/stale — still may include title, enter counts, and pull URLs.
      - `title` string: Title of this room item.
      - `startedAt` string: When the stream, clip, or broadcast segment started (ISO 8601).
      - `totalEnterCount` integer: Lifetime total entries for the last/current room session. May remain on offline payloads as last-known; viewerCount is only set while isLive.
      - `coverUrl` string: Cover image URL.
      - `liveSubOnly` boolean: Whether the TikTok live is subscribers-only.
      - `gameTagId` integer: TikTok live game category id when the room is a gaming broadcast (0 / omitted when not).
      - `liveRoomMode` integer: Live room mode. Example: 1.
      - `paidEvent` object: Paid-live metadata ({eventId, paidType}) when TikTok marks the room as a paid event.
        - `eventId` integer
        - `paidType` integer
      - `streamUrls` string[]: Flat live stream playback URLs (compat). Prefer streamQualities / streams for quality/codec metadata.
      - `streamQualities` object[]: Parsed TikTok live pull qualities ({quality, codec, resolution, bitrate, flv, hls, cmaf, dash, lls}). Prefer hls/cmaf for browsers — FLV is not web-playable.
        - `quality` string
        - `codec` string
        - `resolution` string
        - `bitrate` integer
        - `flv` string
        - `hls` string
        - `cmaf` string
        - `dash` string
      - `streams` object: TikTok live pull URLs keyed by quality (hd/sd/ld/origin/ao/…); h264 preferred when both codecs exist.
        - `hd` object
          - `codec` string
          - `resolution` string
          - `bitrate` integer
          - `flv` string
          - `hls` string
          - `cmaf` string
          - `dash` string
        - `uhd` object
          - `codec` string
          - `resolution` string
          - `bitrate` integer
          - `flv` string
          - `hls` string
          - `cmaf` string
          - `dash` string
        - `sd` object
          - `codec` string
          - `resolution` string
          - `bitrate` integer
          - `flv` string
          - `hls` string
          - `cmaf` string
          - `dash` string
        - `ld` object
          - `codec` string
          - `resolution` string
          - `bitrate` integer
          - `flv` string
          - `hls` string
          - `cmaf` string
          - `dash` string

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)