YouTube

List a channel's live streams

Read one page of a channel's Live tab (30 streams): upcoming, live and past streams with title, URL, thumbnail, view or waiting count, displayed time text, duration and a continuation token. Items are returned in lives. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/youtube/channel/lives

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/youtube/channel/lives
  • Auth: API key in header x-api-key

Query parameters

channelIdstring

YouTube channel ID (UC…) of the channel; exactly one of channelId, handle or url identifies the channel on the first page.

handlestring

Channel handle with or without @.

urlstring

Channel URL (youtube.com/@handle, /channel/UC…, /user/name, /c/name or a legacy youtube.com/name link).

continuationTokenstring

YouTube's own continuation token for the next page, or null at the end. Pass it back unchanged as continuationToken; tokens are caller-carried and never stored.

number
OR
string

Earliest publication time to include, ISO 8601 or Unix seconds.

number
OR
string

Publication time to stop before, ISO 8601 or Unix seconds; later than since.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.