List channel streams

listChannelStreams(id, query?, options?): ChannelStreamsPage

GET/v1/channels/{id}/streams1 Credit

Lists the channel Live tab: current broadcasts and past streams. Uploads live on List channel videos. The two lists are different YouTube tabs and do not substitute for each other.

Page with the returned next_cursor.

Security

API Token

The preferred authorization scheme for the YouTube Transcript API. Create a key with transcripts:read in the developer dashboard.

Example: Authorization: Bearer YOUR_API_KEY

See Authentication for scopes and rate limits.

Accepted permissions (at least one required)

transcripts:read

ParametersExpand Collapse

id:string

Path param:

Channel handle or canonical channel ID.

cursor?:string

Query param:

Continuation cursor from the previous response.

ReturnsExpand Collapse

channel_id:string

Canonical channel ID.

videos:ChannelVideo[]

Stream items for this page. Same video card shape as channel uploads.

has_more:boolean

Whether another page is available.

next_cursor?:string

Cursor for the next page.

List channel streams

const response = await fetch(
  "https://api.ytapi.dev/v1/channels/@MrBeast/streams",
  {
    headers: {
      Authorization: `Bearer ${process.env.YT_API_KEY}`,
    },
  },
);

const page = await response.json();
console.log(page.videos.length, page.next_cursor);

import os
import requests

response = requests.get(
    "https://api.ytapi.dev/v1/channels/@MrBeast/streams",
    headers={"Authorization": f"Bearer {os.environ['YT_API_KEY']}"},
)

print(response.json())

curl -X GET "https://api.ytapi.dev/v1/channels/@MrBeast/streams" \
  -H "Authorization: Bearer $YT_API_KEY"

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.ytapi.dev/v1/channels/@MrBeast/streams", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("YT_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}

200 example

{
  "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "has_more": true,
  "next_cursor": "yt_7c0e86b240fe81347072",
  "videos": [
    {
      "video_id": "abcLiveStream",
      "title": "Live: $1 vs $1,000,000 Hotel",
      "length_text": "LIVE",
      "thumbnails": [
        { "url": "https://i.ytimg.com/vi/abcLiveStream/hqdefault.jpg", "width": 480, "height": 360 }
      ]
    }
  ]
}