List YouTube channel live streams
List a YouTube channel's live, scheduled and past streams.
Headers
Get your API keyAPI key (`sfk_...`)
YouTube channel id whose live streams should be listed, such as `UCWsDFcIhY2DBi3GB5uykGXA`.
min 1 chars · max 4096 chars
YouTube channel handle whose live streams should be listed, with or without a leading @.
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 8192 chars
Endpoint-specific response payload.
Whether the channel was found. `found` may still have no streams.
one of: found, not_found
Streams on this page, newest first, with any stream on air now at the top.
YouTube video identifier of the stream.
min 1 chars
Public YouTube watch URL for the stream.
min 1 chars
Stream title when available.
Stream thumbnail image URL when available.
`live` while the stream is on air, `upcoming` for a scheduled stream, `ended` for a past stream; null when YouTube doesn't say.
one of: live, upcoming, ended, null
Views of a past stream, as YouTube rounds them (`2.3M` is 2300000). Null while live or upcoming.
≥ 0
People watching now, as YouTube rounds it. Only set while the stream is live.
≥ 0
The count label YouTube shows, such as `2.3M`, `33K watching` or `16 waiting`. Never a start time.
The time label YouTube shows, such as `Streamed 2d ago`, or `Scheduled for 11/20/26, 3:00 PM` for an upcoming stream. A scheduled time carries no time zone, so it is left as text rather than parsed.
Length of a past stream in seconds when available.
≥ 0
Length label of a past stream, such as `2:43:42`.
Pagination information for the current response.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/youtube/channels/live-streams?handle=IShowSpeed" \
-H "x-api-key: YOUR_API_KEY"Responses
YouTube channel live streams.