TikTok TikTok Live

Checks if a TikTok user is currently live streaming and retrieves their live room details.

1 credit / request

GET /v1/tiktok/user/live Try it

TikTok TikTok Live
GET /v1/tiktok/user/live

Checks if a TikTok user is currently live streaming and retrieves their live room details.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex

Parameters:
- handle (query · string · required) = thejustalex

Overview

WakeScrap exposes this TikTok endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Checks if a TikTok user is currently live streaming and retrieves their live room details. Returns `liveRoomUserInfo` (nickname, avatar, followerCount, roomId) and `liveRoom` (title, startTime, status, `liveRoomStats` with enterCount and userCount, plus `streamData` with playback URLs in multiple qualities).

Required params: handle.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

handle string required

TikTok handle

Example:

thejustalex


              curl 'https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/tiktok/user/live?handle=thejustalex"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "liveRoomUserInfo": {
    "avatarLarger": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=c39a7259&x-expire...",
    "avatarMedium": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=7da1901a&x-expires=...",
    "avatarThumb": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=baf34a19&x-expires=...",
    "id": "6742945285876515845",
    "nickname": "JustAlex",
    "secUid": "MS4wLjABAAAA3_8rhYkKsHyYO45EzOF7RBQJRs1EaHBqHFtYIaz3aka44bMVgCLONvFaXPkddJei",
    "secret": false,
    "uniqueId": "thejustalex",
    "verified": false,
    "roomId": "7523685855395842871",
    "signature": "🔴LIVE EVERYDAY🔴\n—\n📧[email protected]📧\nSocials 👇",
    "status": 2,
    "followStatus": 0,
    "followingCount": 1225,
    "followerCount": 601562
  },
  "liveRoom": {
    "coverUrl": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=524467bc&x-expires=...",
    "squareCoverImg": "https://p16-webcast.tiktokcdn-us.com/webcast-oci-tx/98159d71f96ce0a13c8234c485082e14~tplv-obj.image",
    "title": "6'13 Grateful Streamer",
    "startTime": 1751744708,
    "status": 2,
    "paidEvent": {
      "event_id": 0,
      "paid_type": 0
    },
    "liveSubOnly": 0,
    "liveRoomMode": 6,
    "hashTagId": 5,
    "gameTagId": 1983,
    "liveRoomStats": {
      "enterCount": 30960,
      "userCount": 804
    },
    "streamData": {
      "pull_data": {
        "options": {
          "default_quality": "...",
          "qualities": "...",
          "show_quality_button": "..."
        },
        "stream_data": "{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"..."
      }
    },
    "streamId": "3576322110592123836",
    "multiStreamScene": 0,
    "multiStreamSource": 0,
    "hevcStreamData": {
      "pull_data": {
        "options": {
          "default_quality": "...",
          "qualities": "...",
          "show_quality_button": "..."
        },
        "stream_data": "{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"..."
      }
    }
  }
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}