Check TikTok LIVE with two REST calls. Send a handle to find out whether a creator is live right now: active streams return is_live true with the available live room details, and an account that is offline returns is_live false. Then pass room_id and user_id to the live info endpoint for a smaller, curated response with room_id, like_count, viewer_count, status, title, cover_url and owner.
| Endpoint | What it returns | Credits/call | USD/call (Freelance plan) |
|---|---|---|---|
/v1/tiktok/live | Live Info | 1 | $0.0017 |
/v1/tiktok/user_live | Live | 1 | $0.0017 |
/v1/tiktok/liveLive Info 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
room_id | string | yes | TikTok live room id. Get this from `/v1/tiktok/user/live` in `liveRoomUserInfo.roomId` or `liveRoom.id` when the user is live. |
user_id | string | yes | TikTok numeric user id for the live owner. Get this from `/v1/tiktok/profile` in `user.id`. |
Sample response (trimmed):
{
"room_id": "7523685855395842871",
"like_count": 4317,
"viewer_count": 268,
"status": "live",
"title": "6'13 Grateful Streamer",
"cover_url": "https://p16-webcast.tiktokcdn-us.com/webcast/cover.jpeg",
"owner": {
"id": "6742945285876515845",
"username": "thejustalex",
"display_name": "JustAlex"
}
}/v1/tiktok/user_liveLive 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
handle | string | yes | TikTok handle |
curl -H "X-Scapi-Key: $SCAPI_KEY" "https://api.scrapall.bipsport.com/scapi/v1/tiktok/live"import os, requests
r = requests.get("https://api.scrapall.bipsport.com/scapi/v1/tiktok/live",
headers={"X-Scapi-Key": os.environ["SCAPI_KEY"]})
print(r.json())Call the live status endpoint with handle. If the creator is streaming, the response has is_live set to true with the available live room details. If the account is offline, it returns is_live false, so you can poll a list of creators and react only to active streams.
Call the live info endpoint with room_id and user_id, which you get from the live status response. It returns a smaller, curated response with room_id, like_count, viewer_count, status, title, cover_url and owner.
The live status endpoint starts from a handle and tells you whether the creator is live, with the room details that are available. The live info endpoint starts from room_id and user_id and returns a compact set of fields for one live room, which is easier to log over time.
Yes. Call the live info endpoint at an interval for the same room_id and user_id and store viewer_count and like_count with your own timestamp. That gives you a simple timeline of how a stream performs while it is running.
No. You send a public handle, or a room_id and user_id, and get JSON back. The endpoints return public live data, so no TikTok login or session cookie is needed on your side.
Open the Buy page, pick the Freelance plan and pay in USDT on TRC20 or ERC20. The key is shown once, right after the payment is confirmed on-chain.
The cost table on this page lists credits per call for each endpoint. The Freelance plan is $45 for 27,000 credits per 30 days.
Full reference: all tiktok endpoints.