List YouTube channel live streams

List a YouTube channel's live, scheduled and past streams.

GET/v1/youtube/channels/live-streams
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
channelIdstringquery

YouTube channel id whose live streams should be listed, such as `UCWsDFcIhY2DBi3GB5uykGXA`.

min 1 chars · max 4096 chars

handlestringquery

YouTube channel handle whose live streams should be listed, with or without a leading @.

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 8192 chars

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

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.

datastreams[]id
string

YouTube video identifier of the stream.

min 1 chars

datastreams[]url
string

Public YouTube watch URL for the stream.

min 1 chars

datastreams[]title
stringnullable

Stream title when available.

datastreams[]thumbnailUrl
stringnullable

Stream thumbnail image URL when available.

datastreams[]status
stringnullable

`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

datastreams[]viewCount
integernullable

Views of a past stream, as YouTube rounds them (`2.3M` is 2300000). Null while live or upcoming.

≥ 0

datastreams[]watchingCount
integernullable

People watching now, as YouTube rounds it. Only set while the stream is live.

≥ 0

datastreams[]viewCountText
stringnullable

The count label YouTube shows, such as `2.3M`, `33K watching` or `16 waiting`. Never a start time.

datastreams[]publishedTimeText
stringnullable

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.

datastreams[]durationSeconds
integernullable

Length of a past stream in seconds when available.

≥ 0

datastreams[]durationText
stringnullable

Length label of a past stream, such as `2:43:42`.

Pagination information for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.