TikTok LIVE
Fetch information from the TikTok LIVE Webcast API.
The TikTok LIVE API provides real-time access to live stream data including chat messages, gifts, viewer counts, and more. Connect to any public TikTok LIVE stream via WebSocket or fetch signed URLs for direct API access.
Retrieve Webcast feed
Fetch the TikTok LIVE webcast feed for a specific region. Gets a random sampling of creators for a region.
Query Parameters
Region enum shared across providers that route through the pooled DC
vendors. Lives in its own file (with zero imports) so consumers can
load it without dragging in pooled-dc.ts's singleton init — which
itself depends on OculusDc / OxyLabsDc and would otherwise close
a module-init cycle the bundler resolves into a TDZ violation.
Header Parameters
Where a scraped image URL should be served from. Selected per-request via the
x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.
Responses
Response Attributes
Region enum shared across providers that route through the pooled DC
vendors. Lives in its own file (with zero imports) so consumers can
load it without dragging in pooled-dc.ts's singleton init — which
itself depends on OculusDc / OxyLabsDc and would otherwise close
a module-init cycle the bundler resolves into a TDZ violation.
Retrieve hashtag list
Retrieve the list of available hashtags for TikTok LIVE streams.
Header Parameters
Where a scraped image URL should be served from. Selected per-request via the
x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.
Responses
Response Attributes
Retrieve bulk live check
A bulk-check endpoint to determine if a group of TikTok users (up to 50 at once) are live. It uses a highly optimized job-based system for checking large numbers of users quickly.
Header Parameters
Access token from a 3rd-party Euler OAuth app.
Raw TikTok cookies for direct authentication.
Request Body
RequiredThe body of the request containing user numeric IDs (e.g. 7602356191083907865).
Responses
Response Attributes
Retrieve Webcast rankings
Retrieve TikTok LIVE rankings for a specific region. This is NOT a catalogue endpoint, and is available with any paid plan.
Query Parameters
Region enum shared across providers that route through the pooled DC
vendors. Lives in its own file (with zero imports) so consumers can
load it without dragging in pooled-dc.ts's singleton init — which
itself depends on OculusDc / OxyLabsDc and would otherwise close
a module-init cycle the bundler resolves into a TDZ violation.
Header Parameters
Access token from a 3rd-party Euler OAuth app.
Raw TikTok cookies for direct authentication.
Where a scraped image URL should be served from. Selected per-request via the
x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.
Responses
Response Attributes
Region enum shared across providers that route through the pooled DC
vendors. Lives in its own file (with zero imports) so consumers can
load it without dragging in pooled-dc.ts's singleton init — which
itself depends on OculusDc / OxyLabsDc and would otherwise close
a module-init cycle the bundler resolves into a TDZ violation.