Skip to main content
GET
/
api
/
v1
/
live
/
{roomId}
Get live room details by room ID
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/live/{roomId} \
  --header 'x-rapidapi-key: <api-key>'
{
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2025-03-12T14:32:01.498Z",
    "cached": false,
    "version": "2025-01"
  },
  "data": {
    "room_id": "7351234567890123456",
    "title": "gaming with chat",
    "status": 2,
    "viewer_count": 14200,
    "like_count": 380000,
    "is_live": true,
    "streamer": {
      "username": "charlidamelio",
      "display_name": "charli d'amelio",
      "avatar_url": "https://p16-sign.tiktokcdn-us.com/..."
    }
  },
  "pagination": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns full metadata for a specific live room including the streamer profile, viewer count, and live status. Room data is cached for 2 minutes.

Authorizations

x-rapidapi-key
string
header
required

Your RapidAPI subscription key. Injected automatically by the RapidAPI gateway in production.

Path Parameters

roomId
string<int64>
required

Numeric TikTok room ID

Pattern: ^\d+$

Response

Success

meta
object

Response metadata present in every API response

data
object

Details for a single TikTok live room

pagination
object

Always null; this endpoint returns a single object and does not paginate.

Example:

null

error
object

Error details. Present only when the request failed; null on success.