YouTube Channel Live Streams API
A channel's Live tab: what is on air now, what is scheduled, and every past stream with its views and length.
GET /v1/youtube/channels/live-streams1 credit Failed requests are free
About this endpoint
GET /v1/youtube/channels/live-streams takes a handle or channelId and returns data.streams, newest first, with any stream on air now at the top. Each stream has id, url, title, thumbnailUrl and a status of live, upcoming or ended. A live stream carries watchingCount; a past one carries viewCount, durationSeconds and publishedTimeText. Pass data.page.nextCursor as cursor while data.page.hasMore is true.
Counts are YouTube's rounded figures (2.3M), and viewCountText keeps the label as shown. An unknown channel is data.lookupStatus: not_found; a channel that has never streamed is found with no streams.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
YouTube Channel Live Streams API FAQ
How do I list a YouTube channel's live streams via API?
Call GET /v1/youtube/channels/live-streams with your Social Fetch API key (x-api-key) and a handle or channelId. Read data.streams, and page with data.page.nextCursor.
How much does the YouTube Channel Live Streams API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
How do I tell if a channel is live right now?
Check the first stream's status. It is live while a stream is on air, with watchingCount set to the people watching.
How exact are the view counts?
They are YouTube's rounded figures: 2.3M becomes 2300000. viewCountText keeps the label exactly as YouTube shows it.
Other YouTube endpoints
- ChannelGET /v1/youtube/channel
- Channel videosGET /v1/youtube/channels/videos
- Channel shortsGET /v1/youtube/channels/shorts
- Channel searchGET /v1/youtube/channels/search
- Channel community postsGET /v1/youtube/channels/community-posts
- Channel playlistsGET /v1/youtube/channels/playlists
- PlaylistGET /v1/youtube/playlists
- Community postGET /v1/youtube/community-posts