User Live Status
GET/v1/tiktok/user/live1 credit
Tells whether a TikTok account is live right now, with its live room details and the account's basic profile.
01Query parameters
| Name | Type | Description |
|---|---|---|
| handlerequired | string | The account's username, with or without `@`, or its profile URL. |
02Request
curl "https://api.scrapesocial.ai/v1/tiktok/user/live?handle=thejustalex" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/tiktok/user/live?handle=babagaming_22
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"is_live": true,
"liveRoom": {
"coverUrl": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d58764c4552bc4800c6bb20740590c50~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=a8c18134&x-expires=1793120400&x-signature=%2BKag3Sk7d8xu3JvmCs40Nj7PPFw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"squareCoverImg": "",
"title": "",
"startTime": 1792941753,
"status": 2,
"paidEvent": {
"event_id": 0,
"paid_type": 0
},
"liveSubOnly": 0,
"liveRoomMode": 0,
"gameTagId": 0,
"liveRoomStats": {
"enterCount": 1434,
"userCount": 5
},
"streamData": {
"pull_data": {
"options": {
"default_preview_quality": {
"icon_type": 0,
"level": 0,
"name": "",
"resolution": "",
"sdk_key": "",
"v_codec": ""
},
"default_quality": {
"icon_type": 0,
"level": 0,
"name": "720p",
"resolution": "",
"sdk_key": "hd",
"v_codec": ""
},
"forced_low_latency": false,
"max_drm_lenient_size": "",
"max_drm_lenient_size_backup": "",
"qualities": [
{
"icon_type": 0,
"level": 3,
"name": "720p",
"resolution": "",
"sdk_key": "hd",
"v_codec": ""
}
],
"show_quality_button": false,
"support_low_latency": false
},
"stream_data": "{\"common\":{\"session_id\":\"167-2026102601100840BF363838912340F45A\",\"room_id\":7700625972861324065,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"default\\\\\\\",\\\\\\\"cdn\\\\\\\":1525,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"rule_id\\\\\\\":-1}}\\\"}\",\"user_count\":3,\"peer_anchor_level\":36,\"max_push_resolution\":\"1080P\",\"default_audio_track\":\"en\"},\"data\":{\"hd\":{\"main\":{\"flv\":\"https://pull…"
},
"push_data": {
"push_stream_level": 0,
"resolution_params": {},
"stream_data": ""
}
},
"streamId": "4443777926540297085",
"multiStreamScene": 0,
"multiStreamSource": 0,
"hevcStreamData": {
"pull_data": {
"options": {
"default_preview_quality": {
"icon_type": 0,
"level": 0,
"name": "",
"resolution": "",
"sdk_key": "",
"v_codec": ""
},
"default_quality": {
"icon_type": 0,
"level": 0,
"name": "720p",
"resolution": "",
"sdk_key": "hd",
"v_codec": ""
},
"forced_low_latency": false,
"max_drm_lenient_size": "",
"max_drm_lenient_size_backup": "",
"qualities": [
{
"icon_type": 0,
"level": 10,
"name": "Original",
"resolution": "",
"sdk_key": "origin",
"v_codec": ""
},
{
"icon_type": 0,
"level": 3,
"name": "720p",
"resolution": "",
"sdk_key": "hd",
"v_codec": ""
}
],
"show_quality_button": false,
"support_low_latency": false
},
"stream_data": "{\"common\":{\"session_id\":\"167-2026102601100840BF363838912340F45A\",\"room_id\":7700625972861324065,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"default\\\\\\\",\\\\\\\"cdn\\\\\\\":1525,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"rule_id\\\\\\\":-1}}\\\"}\",\"user_count\":3,\"peer_anchor_level\":36,\"max_push_resolution\":\"1080P\",\"default_audio_track\":\"en\"},\"data\":{\"ld\":{\"main\":{\"flv\":\"https://pull…"
},
"push_data": {
"push_stream_level": 0,
"resolution_params": {},
"stream_data": ""
}
}
},
"liveRoomUserInfo": {
"avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d58764c4552bc4800c6bb20740590c50~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=1e280c48&x-expires=1793120400&x-signature=afTVDXZ70%2BVs%2FgSfLpbkOtJC2fY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d58764c4552bc4800c6bb20740590c50~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=a8c18134&x-expires=1793120400&x-signature=%2BKag3Sk7d8xu3JvmCs40Nj7PPFw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d58764c4552bc4800c6bb20740590c50~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=830e7f37&x-expires=1793120400&x-signature=jhCmM%2FNW7cd1OvcUgn5wfZU9FYo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"id": "7308031192074126369",
"nickname": "BABA GAMING",
"secUid": "MS4wLjABAAAAOP1pKKPrTVz7mkMSb28iq_8xkUaVV7HGOI7O_A2EaYWHCbksc89itlStBm2SuaM9",
"secret": false,
"uniqueId": "babagaming_22",
"verified": false,
"roomId": "7700625972861324065",
"signature": "JOIN MY WHATSAP CHANNEL FOR NEW UPDATES ❤️\n 👇",
"status": 2,
"followStatus": 0,
"followingCount": 940,
"followerCount": 409930
}
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
The answer has `is_live`, `liveRoom` (title, start time, status, viewer stats, stream URLs) and `liveRoomUserInfo` (the account with its counts and `roomId`). An account that is not live still costs 1 credit, since its status is returned. An unknown account is a free 404.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.