Skip to main content

​
GET /webcast/room_cover

Get the high-quality cover image (thumbnail) URL of an active live stream. Returns the same image TikTok displays on the live feed before a user taps to watch. Image quality: Returns the highest resolution available from TikTok’s CDN. Cover images are typically 720x960 or higher, served as JPEG/WebP from TikTok’s image CDN. Use cases: Building live stream galleries, social media embeds, notification cards with stream previews, or monitoring dashboards that show stream thumbnails alongside viewer counts. Note: Cover images are set by the streamer before going live. If no custom cover is set, TikTok uses a default or auto-generated thumbnail. Returns an error if the user is not currently live.

​
Parameters

ParameterTypeRequiredDescription
unique_idstringNoTikTok username
room_idstringNoTikTok room ID

​
Response

{ "status_code": 0, "data": { "room_id": "...", "cover_url": "https://..." } }

​
Examples

const res = await fetch('https://api.tik.tools/webcast/room_cover?unique_id=username&apiKey=YOUR_KEY');
const { data } = await res.json();
console.log(data.cover_url);