TikTok Scraper
Get TikTok Live Info
Gets curated room-level info for a TikTok live using TokAPI's live info endpoint. Use `/v1/tiktok/user/live` first to find the `room_id`. If you only have a TikTok handle and need the user's numeric id, use `/v1/tiktok/profile` first to get `user.id`. This endpoint is separate from `/v1/tiktok/user/live` because it uses a different upstream call and returns a smaller response with the most relevant fields: `room_id`, `like_count`, `viewer_count`, `status`, `title`, `cover_url`, and `owner`.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| room_idstring · required | string | required | TikTok live room id. Get this from `/v1/tiktok/user/live` in `liveRoomUserInfo.roomId` or `liveRoom.id` when the user is live. |
| user_idstring · required | string | required | TikTok numeric user id for the live owner. Get this from `/v1/tiktok/profile` in `user.id`. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"owner": {
"type": "object",
"additionalProperties": {}
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"room_id": {
"type": "string"
},
"cover_url": {
"type": "string"
},
"like_count": {
"type": "number"
},
"viewer_count": {
"type": "number"
}
},
"additionalProperties": true
}