← API Store
Social
TikTok
TikTok
Is a TikTok account live
GET /tiktok/v1/user/liveEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
usernamerequired | string | Example: tiktok |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"credits_used": 1,
"live": false,
"room": {
"cover": "https://p16-webcast.tiktokcdn.com/webcast-va/2d40841fa55af281b3c825908f04ebc1.jpg~tplv-obj.image",
"hls": null,
"likes": 382959,
"started_at": "2026-10-06T21:56:52.000Z",
"title": "Rihanna x FB LIVE",
"viewers": 1
},
"room_id": "7693676830666705678",
"room_status": 4,
"stats": {
"enterCount": 382959,
"userCount": 1
},
"stream_data": {
"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": [
{
"…": "6 fields"
},
{
"…": "6 fields"
},
"… 3 more"
],
"show_quality_button": false,
"support_low_latency": false
},
"stream_data": "{\"common\":{\"session_id\":\"173-2026102319464482CD1B0868CC0E5123DF\",\"room_id\":7693676830666705678,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sche…"
},
"push_data": {
"push_stream_level": 0,
"resolution_params": {},
"stream_data": ""
}
},
"user": {
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=…",
"avatars": {
"larger": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=…",
"medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=96…",
"thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.webp?dr=96…"
},
"bio_link": null,
"commerce": null,
"created_at": null,
"followers": 96403393,
"following": 1,
"friends": null,
"id": "107955",
"language": null,
"likes": null,
"likes_given": null,
"nickname": "TikTok",
"organization": null,
"private": false,
"raw_stats": {
"followerCount": 96403393,
"followingCount": 1
},
"region": null,
"sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
"secret": false,
"signature": "Your next discovery is waiting on TikTok.",
"url": "https://www.tiktok.com/@tiktok",
"username": "tiktok",
"verified": true,
"videos": null
},
"username": "tiktok"
} Response fields (77)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.live | boolean |
$.room | object |
$.room.cover | string |
$.room.hls | null |
$.room.likes | integer |
$.room.started_at | string |
$.room.title | string |
$.room.viewers | integer |
$.room_id | string |
$.room_status | integer |
$.stats | object |
$.stats.enterCount | integer |
$.stats.userCount | integer |
$.stream_data | object |
$.stream_data.pull_data | object |
$.stream_data.pull_data.options | object |
$.stream_data.pull_data.options.default_preview_quality | object |
$.stream_data.pull_data.options.default_preview_quality.icon_type | integer |
$.stream_data.pull_data.options.default_preview_quality.level | integer |
$.stream_data.pull_data.options.default_preview_quality.name | string |
$.stream_data.pull_data.options.default_preview_quality.resolution | string |
$.stream_data.pull_data.options.default_preview_quality.sdk_key | string |
$.stream_data.pull_data.options.default_preview_quality.v_codec | string |
$.stream_data.pull_data.options.default_quality | object |
$.stream_data.pull_data.options.default_quality.icon_type | integer |
$.stream_data.pull_data.options.default_quality.level | integer |
$.stream_data.pull_data.options.default_quality.name | string |
$.stream_data.pull_data.options.default_quality.resolution | string |
$.stream_data.pull_data.options.default_quality.sdk_key | string |
$.stream_data.pull_data.options.default_quality.v_codec | string |
$.stream_data.pull_data.options.forced_low_latency | boolean |
$.stream_data.pull_data.options.max_drm_lenient_size | string |
$.stream_data.pull_data.options.max_drm_lenient_size_backup | string |
$.stream_data.pull_data.options.qualities | array |
$.stream_data.pull_data.options.qualities[] | object | string |
$.stream_data.pull_data.options.qualities[].… | string |
$.stream_data.pull_data.options.show_quality_button | boolean |
$.stream_data.pull_data.options.support_low_latency | boolean |
$.stream_data.pull_data.stream_data | string |
$.stream_data.push_data | object |
$.stream_data.push_data.push_stream_level | integer |
$.stream_data.push_data.resolution_params | object |
$.stream_data.push_data.stream_data | string |
$.user | object |
$.user.avatar | string |
$.user.avatars | object |
$.user.avatars.larger | string |
$.user.avatars.medium | string |
$.user.avatars.thumb | string |
$.user.bio_link | null |
$.user.commerce | null |
$.user.created_at | null |
$.user.followers | integer |
$.user.following | integer |
$.user.friends | null |
$.user.id | string |
$.user.language | null |
$.user.likes | null |
$.user.likes_given | null |
$.user.nickname | string |
$.user.organization | null |
$.user.private | boolean |
$.user.raw_stats | object |
$.user.raw_stats.followerCount | integer |
$.user.raw_stats.followingCount | integer |
$.user.region | null |
$.user.sec_uid | string |
$.user.secret | boolean |
$.user.signature | string |
$.user.url | string |
$.user.username | string |
$.user.verified | boolean |
$.user.videos | null |
$.username | string |