YouTube hub

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-streams

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.