Get user live stream from TikTok with KonbiniAPI

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.

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

Perfect for

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

Get your API key View Full API Reference

See other TikTok endpoints

1. Make the request

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();

2. Get clean JSON

Response (200 OK)

{
  "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
      }
    ]
  }
}