Get user live stream — TikTok API

Returns the current live stream for a user, including stream URLs and viewer count. Returns 404 if the user is not currently live.

Get free API key View the docs

GET/v1/tiktok/users/{username}/live1 credit per request

Example response200OK

{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "Video",
    "id": "https://www.tiktok.com/@khaby.lame/live",
    "url": "https://www.tiktok.com/@khaby.lame/live",
    "entityId": "7600000000000000001",
    "published": "2026-02-27T18:36:42.000Z",
    "isLive": true,
    "viewCount": 42600000,
    "viewerCount": 15000,
    "content": "When you realize there is a simpler way #learnfromkhaby",
    "attributedTo": {
      "type": "Person",
      "id": "https://www.tiktok.com/@khaby.lame",
      "url": "https://www.tiktok.com/@khaby.lame",
      "entityId": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
      "name": "Khabane Lame",
      "preferredUsername": "khaby.lame",
      "summary": "Just a guy who reacts",
      "attachment": [
        {
          "type": "Link",
          "href": "https://linktr.ee/khaby.lame",
          "rel": "preferred"
        }
      ],
      "published": "2020-03-15T00:00:00.000Z",
      "isPrivate": false,
      "isVerified": true,
      "isLive": false,
      "hasLikes": true,
      "hasPlaylists": true,
      "followerCount": 160300000,
      "followingCount": 85,
      "language": "en",
      "likeCount": 2600000000,
      "likedCount": 5300,
      "mediaCount": 1309,
      "icon": {
        "type": "Image",
        "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
        "width": 576,
        "height": 1024
      },
      "image": [
        {
          "type": "Image",
          "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
          "width": 576,
          "height": 1024
        }
      ]
    },
    "image": [
      {
        "type": "Image",
        "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
        "width": 576,
        "height": 1024
      }
    ],
    "attachment": [
      {
        "type": "Video",
        "url": [
          "https://webcast.tiktok.com/live/pull/l4/stream.flv"
        ],
        "mediaType": "video/x-flv",
        "width": 576,
        "height": 1024,
        "name": "flv",
        "codec": "h264",
        "bitrate": 2500000
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/tiktok/users/{username}/live. Authentication and error conventions stay consistent across endpoints. This page shows the path, parameters, response shape, limits, and credit rule for this operation.

Built for

Real-time live event monitoring and webhook alerting
Streaming activity tracking for creator analytics tools
Live audience size measurement and peak viewer reporting

Full reference for this endpoint

const response = await fetch("https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/live", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});

const data = await response.json();

Parameters1

usernamerequiredIn · PathType · stringTikTok username (with or without @ symbol)

What you will probably call next.

The TikTok endpoints around this one — the same object at a different depth, or the same kind of read.

All TikTok endpoints Browse every platform

Try it on your own data.

Get a free API key and make this request in minutes. Failed and timed-out requests are automatically refunded.

Get free API key Endpoint reference