SCscrapecreators
TikTok

Live Info

Changed on

Gets curated room-level info for a TikTok live from TikTok's public live-room source. 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. TikTok's room-access refusal returns HTTP 403 with no credit charge. The creator may have enabled audience controls; this response does not mean the profile was deleted. Other upstream failures remain errors rather than successful empty rooms.

get/v1/tiktok/live

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v1/tiktok/live
  • Auth
    API key in header x-api-key

Query parameters

room_idstring 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

TikTok numeric user id for the live owner. Get this from /v1/tiktok/profile in user.id.

Response

Successful response

Changes