TIKTOK API
Live
Retrieve live from TikTok with a single API request.
GET
/api/data/v1/tiktok/user/live1credit base cost
Request parameters
Up to 1 creditTikTok handle
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/tiktok/user/live?handle=thejustalex' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"credits_charged": 1,
"is_live": 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-expires=1751918400&x-signature=2Q%2F13wVO%2F%2F5OFBDinwMuULyBINc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
"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=1751918400&x-signature=WDVM4wsOBsWKV04aQNYqBRnllxQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
"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=1751918400&x-signature=fWClWNGmv23Nggnk7gE17yC3D78%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5be10d83&idc=useast5",
"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=1751918400&x-signature=dYrBW7UodqMDScfs4YMnmfK24Zg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
"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": {
"icon_type": 0,
"level": 0,
"name": "540p",
"resolution": "",
"sdk_key": "sd",
"v_codec": ""
},
"qualities": [
{
"icon_type": 6,
"level": 10,
"name": "Original",
"resolution": "",
"sdk_key": "origin",
"v_codec": ""
}
],
"show_quality_button": false
},
"stream_data": "{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2137}}\\\"}\",\"user_count\":798,\"peer_anchor_level\":39},\"data\":{\"hd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd.flv?expire=1752957742&sign=0b9f362ee81ab0494d8a2a7a79151d1b\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd/index.m3u8?expire=1752957742&sign=b8c9cd9d85166f52d3beeda633ffc4dc\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd/index.mpd?expire=1752957742"
}
},
"streamId": "3576322110592123836",
"multiStreamScene": 0,
"multiStreamSource": 0,
"hevcStreamData": {
"pull_data": {
"options": {
"default_quality": {
"icon_type": 0,
"level": 0,
"name": "540p",
"resolution": "",
"sdk_key": "sd",
"v_codec": ""
},
"qualities": [
{
"icon_type": 6,
"level": 10,
"name": "Original",
"resolution": "",
"sdk_key": "origin",
"v_codec": ""
}
],
"show_quality_button": false
},
"stream_data": "{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2137}}\\\"}\",\"user_count\":811,\"peer_anchor_level\":39},\"data\":{\"origin\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836.flv?expire=1752957742&sign=e3deaa3e74cc33921accfe3e6165c407\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836/index.m3u8?expire=1752957742&sign=dabd5577a80d25e975119ad5de32d7c4\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836/index.mpd?expire=1752957742&sign"
}
}
}
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"credits_remaining": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"is_live": {
"type": "boolean"
},
"liveRoomUserInfo": {
"type": "object",
"properties": {
"avatarLarger": {
"type": "string"
},
"avatarMedium": {
"type": "string"
},
"avatarThumb": {
"type": "string"
},
"id": {
"type": "string"
},
"nickname": {
"type": "string"
},
"secUid": {
"type": "string"
},
"secret": {
"type": "boolean"
},
"uniqueId": {
"type": "string"
},
"verified": {
"type": "boolean"
},
"roomId": {
"type": "string"
},
"signature": {
"type": "string"
},
"status": {
"type": "integer"
},
"followStatus": {
"type": "integer"
},
"followingCount": {
"type": "integer"
},
"followerCount": {
"type": "integer"
}
}
},
"liveRoom": {
"type": "object",
"properties": {
"coverUrl": {
"type": "string"
},
"squareCoverImg": {
"type": "string"
},
"title": {
"type": "string"
},
"startTime": {
"type": "integer"
},
"status": {
"type": "integer"
},
"paidEvent": {
"type": "object",
"properties": {
"event_id": {
"type": "integer"
},
"paid_type": {
"type": "integer"
}
}
},
"liveSubOnly": {
"type": "integer"
},
"liveRoomMode": {
"type": "integer"
},
"hashTagId": {
"type": "integer"
},
"gameTagId": {
"type": "integer"
},
"liveRoomStats": {
"type": "object",
"properties": {
"enterCount": {
"type": "integer"
},
"userCount": {
"type": "integer"
}
}
},
"streamData": {
"type": "object",
"properties": {
"pull_data": {
"type": "object",
"properties": {
"options": {
"type": "object",
"properties": {
"default_quality": {
"type": "object",
"properties": {
"icon_type": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"resolution": {
"type": "string"
},
"sdk_key": {
"type": "string"
},
"v_codec": {
"type": "string"
}
}
},
"qualities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"icon_type": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"resolution": {
"type": "string"
},
"sdk_key": {
"type": "string"
},
"v_codec": {
"type": "string"
}
}
}
},
"show_quality_button": {
"type": "boolean"
}
}
},
"stream_data": {
"type": "string"
}
}
}
}
},
"streamId": {
"type": "string"
},
"multiStreamScene": {
"type": "integer"
},
"multiStreamSource": {
"type": "integer"
},
"hevcStreamData": {
"type": "object",
"properties": {
"pull_data": {
"type": "object",
"properties": {
"options": {
"type": "object",
"properties": {
"default_quality": {
"type": "object",
"properties": {
"icon_type": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"resolution": {
"type": "string"
},
"sdk_key": {
"type": "string"
},
"v_codec": {
"type": "string"
}
}
},
"qualities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"icon_type": {
"type": "integer"
},
"level": {
"type": "integer"
},
"name": {
"type": "string"
},
"resolution": {
"type": "string"
},
"sdk_key": {
"type": "string"
},
"v_codec": {
"type": "string"
}
}
}
},
"show_quality_button": {
"type": "boolean"
}
}
},
"stream_data": {
"type": "string"
}
}
}
}
}
}
}
}
}