YouTube Channel Live Streams API
List a channel's live streams: live now, scheduled and past.
- 1 credit per call
- Failed calls are free
- Updated
- youtube.channel-live.list
{ "summary": { "channel_id": "UCSJ4gkVC6NrvII8umztf0Ow", "has_more": false, "tab": "live", "total_items": 25 }, "items": [ { "title": "24/7 halloween ambience ๐ spooky lofi to get chills to", "views": "5.2K watching", "view_count": 5200, "is_live": true, "type": "video", "video_id": "1-LpQekNa9g", "view_count_approximate": true }, { "title": "24/7 deep sleep music ๐ calm ambient to sleep & dream to", "views": "553 watching", "view_count": 553, "is_live": true, "type": "video", "video_id": "nI725iVsyoQ" } ]}
| # | Title | Live now | Views | Video ID | Views | Type |
|---|---|---|---|---|---|---|
| 1 | 24/7 halloween ambience ๐ spooky lofi to get chills to | true | 5200 | 1-LpQekNa9g | 5.2K watching | video |
| 2 | 24/7 deep sleep music ๐ calm ambient to sleep & dream to | true | 553 | nI725iVsyoQ | 553 watching | video |
| 3 | lofi house radio ๐ lounge music to vibe/chill to | true | 1400 | 3PFJ9SETS4M | 1.4K watching | video |
| 4 | lofi hip hop radio ๐ beats to relax/study to | true | 19,000 | rFZHOHl-L8A | 19K watching | video |
| 5 | summer lofi radio โ๏ธ music to put you in a better mood | true | 313 | 0muHFBSiybw | 313 watching | video |
| 6 | sleep lofi radio ๐ relaxing music to sleep/dream to | true | 505 | VAlMDl00mYY | 505 watching | video |
| 7 | synth ambient radio ๐ deep space music to sleep to | true | 146 | GSfT7H87zq4 | 146 watching | video |
| 8 | Study With Me ๐ Pomodoro | true | 544 | qGohtGC5Rtk | 544 watching | video |
| 9 | sad lofi radio โ beats for rainy days | true | 198 | CwPCy1GLS38 | 198 watching | video |
| 10 | asian lofi radio โฉ๏ธ beats to relax/study to | true | 1000 | 1Tl2FtV06qo | 1K watching | video |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| url | string | yes | YouTube channel URL, handle, or channel ID | @LofiGirl |
| limit | integer | no | Maximum number of results to return. From 1 to 500. Default: 100. |
100 |
| max_pages | integer | no | Maximum number of result pages to fetch. From 1 to 100. Default: 5. |
5 |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].title | string | The stream's title. | 24/7 halloween ambience ๐ spooky lofi to get chills to |
| items[].is_live | boolean | Whether it is live now. | true |
| items[].view_count | integer | Viewers now, read from what YouTube shows. | 5200 |
| items[].video_id | string | YouTube's ID for the video. | 1-LpQekNa9g |
| items[].views | string | Viewers as YouTube writes them. | 5.2K watching |
| items[].type | string | What kind of item it is, such as video. | video |
| items[].view_count_approximate | boolean | Whether the view count comes from a rounded figure such as 84K. | true |
| items | array | The channel's live streams. | 25 records |
| summary | object | Totals and paging details for this answer. | 4 fields |
| summary.channel_id | string | YouTube's ID for the channel. | UCSJ4gkVC6NrvII8umztf0Ow |
| summary.has_more | boolean | Whether more items are available. | false |
| summary.tab | string | Which channel tab the items come from. | live |
| summary.total_items | integer | How many items this answer holds. | 25 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "youtube.channel-live.list", "input": { "limit": 100, "max_pages": 5, "url": "@LofiGirl" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "youtube.channel-live.list", "input": { "limit": 100, "max_pages": 5, "url": "@LofiGirl" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "youtube.channel-live.list", "input": { "limit": 100, "max_pages": 5, "url": "@LofiGirl" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Use Upscrape to list the live streams on the @LofiGirl channel and tell me which ones are live right now.
More from the YouTube API
- YouTube Video API1 credit
- YouTube Channel API1 credit
- YouTube Channel Videos API1 credit
- YouTube Search API1 credit
- YouTube Comments API1 credit
- YouTube Channel Shorts API1 credit
- YouTube Channel Playlists API1 credit
- YouTube Playlist API1 credit
- YouTube Channel Community API1 credit
- YouTube Community Post API1 credit
- YouTube Hashtag Videos API1 credit
- YouTube Typeahead Search API1 credit
- YouTube Trending Shorts API1 credit
YouTube Channel Live Streams API FAQ
The short answers. The docs have the long ones.
How much does the YouTube Channel Live Streams API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send url. The input fields below list every option with its type and limits.
Do I need a YouTube login?
No. It reads public YouTube data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds youtube.channel-live.list, checks its price and runs it with the same credits as the REST API.
Your first YouTube call is free.
Up to 100 free credits to start, no card needed.