UnifAPI DocsTiktok
List today's trending TikTok live rooms (ranking)
Returns the daily-rank trending TikTok live rooms. Each entry is a thin ranking row (rank + score + room_id + minimal creator info). Call /tiktok/lives/{room_id} to fetch the full live-room object.
Authorization
bearerAuth AuthorizationBearer <token>
UnifAPI API key (forwarded verbatim as the upstream provider token).
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/tiktok/lives/trending"{
"items": [
{
"rank": 0,
"score": 0,
"room_id": "string",
"owner_username": "string",
"owner_display_name": "string",
"owner_avatar_url": "string"
}
]
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}{
"error": {
"type": "validation_error",
"message": "string",
"request_id": "string",
"issues": [
null
]
}
}