YouTube data

YouTube Channel Live Streams: live now, upcoming and past

Every stream on a YouTube channel's Live tab, up to 100 channels per run: live now with viewers watching, scheduled with the start time, and past streams with views and duration. One row per stream, in YouTube's order. No viewer or chat data. Pay per delivered stream.

$1.00per 1,000 · Stream listed

One stream delivered. Channels that fail or have no Live tab are never charged.

run it
ACTOR=steadydata~youtube-channel-live
URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items"

curl -X POST "$URL?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channels": ["@NASA"], "maxStreamsPerChannel": 30, "language": "en"}'

# rows come straight back as JSON, one object per delivered row

Input

FieldNameWhat it does
channels
required
ChannelsOne per row, up to 100: an @handle, a channel id (UC...) or a channel URL.
maxStreamsPerChannelMax streams per channelCost ceiling per channel; YouTube lists newest first.
statusesStatuses to includeAny of live, upcoming, past. Empty includes all three.
languageLanguageTwo-letter code for labels.
countryCountryTwo-letter code.

What you get back

output schema, one object per delivered row
{
  "channelId": string | null,
  "channelUrl": string | null,
  "channelName": string | null,
  "position": integer | null,
  "videoId": string | null,
  "url": string | null,
  "title": string | null,
  "status": string | null,
  "viewerCount": integer | null,
  "viewCount": integer | null,
  "scheduledStartAt": string | null,
  "streamedText": string | null,
  "durationSeconds": integer | null,
  "thumbnailUrl": string | null,
  "input": string | null,
  "errorCode": string | null,
  "error": string | null,
  "streamStatus": string | null
}
FieldType
channelIdstring, null
channelUrlstring, null
channelNamestring, null
positioninteger, null
videoIdstring, null
urlstring, null
titlestring, null
statusstring, null
viewerCountinteger, null
viewCountinteger, null
scheduledStartAtstring, null
streamedTextstring, null
durationSecondsinteger, null
thumbnailUrlstring, null
inputstring, null
errorCodestring, null
errorstring, null
streamStatusstring, null

Related datasets