TikTok User Stream Detail
https://api.sandbase.ai/v1/api/tiktok/web/user-live-detailReturns current broadcast information for a TikTok user based on their unique handle. Provides stream quality options and room playback data.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 0 optional
Production route
Try the model
Playground
Input
User uniqueId
OutputExample
[
{
"data": {
"data": {
"liveRoom": {
"coverUrl": "https://p16-webcast.tiktokcdn.com/webcast-va/15fc868294ee6483ec460838b7e38dd6.png~tplv-obj.image",
"gameTagId": 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": 6,
"level": 10,
"name": "Original",
"resolution": "",
"sdk_key": "origin",
"v_codec": ""
},
{
"icon_type": 4,
"level": 5,
"name": "1080p",
"resolution": "",
"sdk_key": "uhd",
"v_codec": ""
},
{
"icon_type": 3,
"level": 3,
"name": "720p",
"resolution": "",
"sdk_key": "hd",
"v_codec": ""
},
{
"icon_type": 2,
"level": 2,
"name": "540p",
"resolution": "",
"sdk_key": "sd",
"v_codec": ""
},
{
"icon_type": 1,
"level": 1,
"name": "360p",
"resolution": "",
"sdk_key": "ld",
"v_codec": ""
}
],
"show_quality_button": false,
"support_low_latency": false
},
"stream_data": "{\"common\":{\"session_id\":\"173-2026100620410359FF1FC5C1CE4614A9B5\",\"room_id\":7691362796675582733,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"default\\\\\\\",\\\\\\\"cdn\\\\\\\":2546,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"rule_id\\\\\\\":-1}}\\\"}\",\"default_audio_track\":\"en\"},\"data\":{\"ld\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ld5.flv?expire=1792500063&sign=192696c460d9354d24f40d458fd2638d\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ld5/index.m3u8?expire=1792500063&sign=0f2fe00c4e1786de56db8733fe85b875\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ld5/index.mpd?auth_mode=2&expire=1792500063&sign=c298608fcb83e178b2d41b09d67bee79\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"resolution\\\":\\\"360x640\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ld5\\\",\\\"vbitrate\\\":600000}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ld5.flv?expire=1792500063&sign=37ec8f1e22df8369fa3a38f1587630a7\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ld5/index.m3u8?expire=1792500063&sign=9f5c409d797df83a839df0137f140d9c\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ld5/index.mpd?auth_mode=2&expire=1792500063&sign=0fbb49fdae0b2f88935745ead0db93ea\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":600000,\\\"resolution\\\":\\\"360x640\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ld5\\\"}\"}},\"origin\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998.flv?expire=1792500063&sign=863609dfbcb00f7b2191ee2502dff2cd\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998/index.m3u8?expire=1792500063&sign=21e9c6d1b6e34e9a5a63562453410460\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998/index.mpd?auth_mode=2&expire=1792500063&sign=72138d97b1f1e0feb1f864e99a258a59\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"vbitrate\\\":4289000,\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998.flv?expire=1792500063&sign=77c7602b181c522e49c02ac6fffb9170\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998/index.m3u8?expire=1792500063&sign=9bd434fa52b7b584c012bdb8666f603e\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998/index.mpd?auth_mode=2&expire=1792500063&sign=85a1a13f41e7218bb8674a57ee10b231\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"vbitrate\\\":4289000}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998.flv?expire=1792500063&sign=863609dfbcb00f7b2191ee2502dff2cd&only_audio=1\",\"hls\":\"\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ao/index.mpd?auth_mode=2&expire=1792500063&sign=7cb341b5a13a29aff4c8add1281fdb48\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"stream_suffix\\\":\\\"ao\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998.flv?expire=1792500063&sign=77c7602b181c522e49c02ac6fffb9170&only_audio=1\",\"hls\":\"\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ao/index.mpd?auth_mode=2&expire=1792500063&sign=e4b0551d1460e2897e2a399b59a3a253\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ao\\\",\\\"vbitrate\\\":0}\"}},\"uhd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_uhd5.flv?expire=1792500063&sign=111f86cf0b1ae6a3656d9f7d26b24731\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_uhd5/index.m3u8?expire=1792500063&sign=72f2fa5af57a7a1d48055778baf3734a\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_uhd5/index.mpd?auth_mode=2&expire=1792500063&sign=68a060f44aca18e4db03e23ad4e13505\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"uhd5\\\",\\\"vbitrate\\\":1800000,\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_uhd5.flv?expire=1792500063&sign=f6efec15a11c6942cb5821e34381f373\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_uhd5/index.m3u8?expire=1792500063&sign=73d88896621c965045f5cd2541ba94b9\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_uhd5/index.mpd?auth_mode=2&expire=1792500063&sign=88f1690d2ac33721858a5c277634040b\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"stream_suffix\\\":\\\"uhd5\\\",\\\"vbitrate\\\":1800000,\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"}},\"hd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_hd5.flv?expire=1792500063&sign=8017c9053b1c529df718b0254749a5d4\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_hd5/index.m3u8?expire=1792500063&sign=fd7e9ee6111e930677765c2fcf1cd384\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_hd5/index.mpd?auth_mode=2&expire=1792500063&sign=5ee4b81c7482c89df65e71fd6cdd3e6b\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"hd5\\\",\\\"vbitrate\\\":1600000,\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":2}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_hd5.flv?expire=1792500063&sign=704793f9dac857acfb08bdfc848ee782\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_hd5/index.m3u8?expire=1792500063&sign=2dcbd00c3fb9a589db34de309a71cfff\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_hd5/index.mpd?auth_mode=2&expire=1792500063&sign=69415434fb723cb184c152e6871b09f6\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":1600000,\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":2,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"hd5\\\"}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_sd5.flv?expire=1792500063&sign=9f9edf6597ee7425e4cf85527cfa825d\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_sd5/index.m3u8?expire=1792500063&sign=398861a2d39dc4b39335994595e27459\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_sd5/index.mpd?auth_mode=2&expire=1792500063&sign=b1dbf72ae7940e27ee61d90ffe6a6857\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"sd5\\\",\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"540x960\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_sd5.flv?expire=1792500063&sign=1738bfec4833ada9c48ed037b0bf026e\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_sd5/index.m3u8?expire=1792500063&sign=9d12c1e4de009a6c6e6b112d42ae493e\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_sd5/index.mpd?auth_mode=2&expire=1792500063&sign=bd1e336dba3d33dedaf6835f954cb5da\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"540x960\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"sd5\\\"}\"}}}}"
},
"push_data": {
"push_stream_level": 0,
"resolution_params": {},
"stream_data": ""
}
},
"liveRoomMode": 1,
"liveRoomStats": {
"enterCount": 363455,
"userCount": 1
},
"liveSubOnly": 0,
"multiStreamScene": 0,
"multiStreamSource": 0,
"paidEvent": {
"event_id": 7689516384870466000,
"paid_type": 0
},
"squareCoverImg": "https://p16-webcast.tiktokcdn.com/webcast-oci-tx-va-transfer-us/73621695e430b074fd2b2ac5f2a89656~tplv-obj.image",
"startTime": 1790785060,
"status": 4,
"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": 6,
"level": 10,
"name": "Original",
"resolution": "",
"sdk_key": "origin",
"v_codec": ""
},
{
"icon_type": 4,
"level": 5,
"name": "1080p",
"resolution": "",
"sdk_key": "uhd",
"v_codec": ""
},
{
"icon_type": 3,
"level": 3,
"name": "720p",
"resolution": "",
"sdk_key": "hd",
"v_codec": ""
},
{
"icon_type": 2,
"level": 2,
"name": "540p",
"resolution": "",
"sdk_key": "sd",
"v_codec": ""
},
{
"icon_type": 1,
"level": 1,
"name": "360p",
"resolution": "",
"sdk_key": "ld",
"v_codec": ""
}
],
"show_quality_button": false,
"support_low_latency": false
},
"stream_data": "{\"common\":{\"session_id\":\"173-2026100620410359FF1FC5C1CE4614A9B5\",\"room_id\":7691362796675582733,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"default\\\\\\\",\\\\\\\"cdn\\\\\\\":2546,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"rule_id\\\\\\\":-1}}\\\"}\",\"default_audio_track\":\"en\"},\"data\":{\"hd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_hd.flv?expire=1792500063&sign=d0fadf8cd4f88b7530d9bfe3202a24a9\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_hd/index.m3u8?expire=1792500063&sign=1c7f352616f85b1fbc9827a3c45b79e7\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_hd/index.mpd?auth_mode=2&expire=1792500063&sign=ed42a4d40d3a63f2a44e946d7fc4f987\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1200000,\\\"resolution\\\":\\\"960x540\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_hd.flv?expire=1792500063&sign=58ef49f0a6c4657b32444394a4c40db1\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_hd/index.m3u8?expire=1792500063&sign=ab28917eabf977d01f7cdb7d00b11b93\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_hd/index.mpd?auth_mode=2&expire=1792500063&sign=41fd7e8beadb3e8c181123ef4520a857\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":1200000,\\\"resolution\\\":\\\"960x540\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"hd\\\"}\"}},\"uhd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_uhd.flv?expire=1792500063&sign=2a782b071c47c6e7a9dd9a4595d3a497\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_uhd/index.m3u8?expire=1792500063&sign=527e415c761d97064ca4dd9cb73af0db\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_uhd/index.mpd?auth_mode=2&expire=1792500063&sign=c72a58f9ca264c29810c0fce329bb30f\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"uhd\\\",\\\"vbitrate\\\":1800000,\\\"resolution\\\":\\\"1280x720\\\",\\\"gop\\\":4}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_uhd.flv?expire=1792500063&sign=e53a9c65e860fe21caef570f6d781696\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_uhd/index.m3u8?expire=1792500063&sign=e919417d9a5dd69476d2929e5bb48a69\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_uhd/index.mpd?auth_mode=2&expire=1792500063&sign=94ed48c41c79eada032f5ce286c40ec4\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":1800000,\\\"resolution\\\":\\\"1280x720\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"uhd\\\"}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_sd.flv?expire=1792500063&sign=be8efff621dddeb311b0b0abd59eb808\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_sd/index.m3u8?expire=1792500063&sign=cdab60ca6cb5232728e5a0eb2bed0447\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_sd/index.mpd?auth_mode=2&expire=1792500063&sign=cac80461df19354049818e9f3440483a\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"stream_suffix\\\":\\\"sd\\\",\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"960x540\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_sd.flv?expire=1792500063&sign=e1e54eba83c3dc1d4e93b7c1498db132\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_sd/index.m3u8?expire=1792500063&sign=2ee6a31d445cf7aab05b080f343ccf6e\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_sd/index.mpd?auth_mode=2&expire=1792500063&sign=02a010b37a59042b1556e927f2cce724\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"960x540\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"sd\\\"}\"}},\"ld\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ld.flv?expire=1792500063&sign=8db3cafdd0b0087ef2baf97044abc002\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ld/index.m3u8?expire=1792500063&sign=a4771c0696f2afa29d602718567918c5\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ld/index.mpd?auth_mode=2&expire=1792500063&sign=e12e6e296e9bd3059a410184b838680f\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"resolution\\\":\\\"640x360\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ld\\\",\\\"vbitrate\\\":600000}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ld.flv?expire=1792500063&sign=59c749b6f5920df5bb2d80d04dde0a7a\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ld/index.m3u8?expire=1792500063&sign=62d05bc0f9f750d6871220552c6f0414\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ld/index.mpd?auth_mode=2&expire=1792500063&sign=c6275033024c251fcff8af21504a9276\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ld\\\",\\\"vbitrate\\\":600000,\\\"resolution\\\":\\\"640x360\\\",\\\"gop\\\":4}\"}},\"origin\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998.flv?expire=1792500063&sign=863609dfbcb00f7b2191ee2502dff2cd\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn.com/activity/stream-3578942064601858998/index.m3u8?expire=1792500063&sign=21e9c6d1b6e34e9a5a63562453410460\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998/index.mpd?auth_mode=2&expire=1792500063&sign=72138d97b1f1e0feb1f864e99a258a59\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"vbitrate\\\":4289000,\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998.flv?expire=1792500063&sign=77c7602b181c522e49c02ac6fffb9170\",\"hls\":\"https://pull-hls-f16-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998/index.m3u8?expire=1792500063&sign=9bd434fa52b7b584c012bdb8666f603e\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998/index.mpd?auth_mode=2&expire=1792500063&sign=85a1a13f41e7218bb8674a57ee10b231\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"vbitrate\\\":4289000,\\\"resolution\\\":\\\"1080x1920\\\"}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998.flv?expire=1792500063&sign=863609dfbcb00f7b2191ee2502dff2cd&only_audio=1\",\"hls\":\"\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn.com/activity/stream-3578942064601858998_ao/index.mpd?auth_mode=2&expire=1792500063&sign=7cb341b5a13a29aff4c8add1281fdb48\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=72138d97b1f1e0feb1f864e99a258a59\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ao\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4}\"},\"backup\":{\"flv\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998.flv?expire=1792500063&sign=77c7602b181c522e49c02ac6fffb9170&only_audio=1\",\"hls\":\"\",\"cmaf\":\"https://pull-f5-tt02.tiktokcdn.com/activity-bak/stream-3578942064601858998_ao/index.mpd?auth_mode=2&expire=1792500063&sign=e4b0551d1460e2897e2a399b59a3a253\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792500063\\\\u0026sign=85a1a13f41e7218bb8674a57ee10b231\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ao\\\"}\"}}}}"
},
"push_data": {
"push_stream_level": 0,
"resolution_params": {},
"stream_data": ""
}
},
"streamId": "3578942064601858998",
"title": "TikTok LIVE x LACMA"
},
"stats": {
"followerCount": 96100404,
"followingCount": 1
},
"user": {
"avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=dcc414d2&x-expires=1791460800&x-signature=zlm9l5x7zTbpSptd83cBJs2YFqY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=37ced7c4&x-expires=1791460800&x-signature=GnTtW%2FLDH0UMERodyjGBgrCtL88%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"avatarThumb": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=97735f26&x-expires=1791460800&x-signature=EoslPslve35SlCbeREaR8GQfFrs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=my",
"followStatus": 0,
"id": "107955",
"nickname": "TikTok",
"roomId": "7691362796675582733",
"secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
"secret": false,
"signature": "Your next discovery is waiting on TikTok.",
"status": 4,
"uniqueId": "tiktok",
"verified": true
}
},
"extra": {
"id": "2026100620410359FF1FC5C1CE4614A9B5"
},
"message": "",
"statusCode": 0
}
}
]Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- uniqueId
- string · required
Access
- Provider
- TikTok
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/tiktok/web/user-live-detail
- Authentication
- Bearer API key
API README
TikTok User Stream Detail API
Retrieve broadcast and stream room details for a TikTok account by passing the user handle in uniqueId.
Use cases
- Check whether a specific TikTok creator is broadcasting.
- Retrieve stream playback configurations and video qualities.
- Monitor broadcast activity for target user handles.
Request
curl -X POST "https://api.sandbase.ai/v1/api/tiktok/web/user-live-detail" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"uniqueId": "tiktok"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
uniqueId | string | Yes | User uniqueId |
Example response
Real response for the request above, trimmed to the main fields. User names and long IDs are masked.
{
"data": {
"liveRoom": {
"hevcStreamData": {
"pull_data": {
"options": {
"qualities": [
{
"name": "Original"
}
]
}
}
}
}
}
}
Notes
- Requires the TikTok user handle via
uniqueId.
Related APIs
- TikTok Video IDs from URLs (Batch): Resolves and extracts TikTok video IDs from a list of video URLs.
- TikTok User Sec User ID Extractor: Returns a list of sec_user_id identifiers corresponding to TikTok user profile URLs.
- TikTok Profile Unique IDs: Resolves a batch of TikTok user homepage links to retrieve their corresponding unique identifiers.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/tiktok/web/user-live-detail" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"uniqueId": "tiktok"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
TikTok User Stream DetailThis API TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.07 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the TikTok User Stream Detail API?
Send a POST request to https://api.sandbase.ai/v1/api/tiktok/web/user-live-detail with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the TikTok User Stream Detail API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the TikTok User Stream Detail API accept?
Required: uniqueId (string). The Parameters table and the Playground on this page list every field.
What does the TikTok User Stream Detail API return?
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
Do I need a TikTok developer account or API key?
No. TikTok User Stream Detail runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.