← API Store
Social
YouTube
YouTube
YouTube channel live streams
GET /youtube/v1/channel/livesEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
channelrequired | string | Example: @NASA |
sort | latest | popular | oldest | latest (default), popular or oldest: the tab's own sort chips; next_cursor keeps the order. |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 30,
"credits_used": 1,
"next_cursor": "4qmFsgJgEhhVQ0xBX0RpUjFGZktOdmp1VXBCSG15bFEaRDhnWXJHaW1hQVNZS0pEWmlNbUU1TmpnNUxUQXdNREF0TWpRMVlTMWhNMkZqTFRVNE1qUXlPV0kyWVdWa1l3JTNEJTNE",
"streams": [
{
"badges": [
"Upcoming"
],
"channel": null,
"channel_avatar": null,
"channel_id": null,
"channel_name": null,
"channel_url": null,
"content_type": "video",
"duration": null,
"duration_seconds": null,
"id": "hv867HnY4j4",
"live": false,
"metadata_parts": [
"4 waiting",
"Scheduled for 10/29/26, 3:45 AM"
],
"published": "Scheduled for 10/29/26, 3:45 AM",
"published_text": "Scheduled for 10/29/26, 3:45 AM",
"thumbnail": "https://i.ytimg.com/vi/hv867HnY4j4/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA_PPU0uzNb9xquBEvhbMgnS44GQw",
"thumbnails": [
{
"height": 202,
"url": "https://i.ytimg.com/vi/hv867HnY4j4/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAy9pOMu5V8hecybuOJZSkQgkgnSw",
"width": 360
},
{
"height": 404,
"url": "https://i.ytimg.com/vi/hv867HnY4j4/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA_PPU0uzNb9xquBEvhbMgnS44GQw",
"width": 720
}
],
"title": "U.S. Spacewalk 100",
"type": "video",
"upcoming": true,
"url": "https://www.youtube.com/watch?v=hv867HnY4j4",
"view_count": 4,
"views": "4 waiting"
},
{
"badges": [
"LIVE"
],
"channel": null,
"channel_avatar": null,
"channel_id": null,
"channel_name": null,
"channel_url": null,
"content_type": "video",
"duration": null,
"duration_seconds": null,
"id": "pAKqJxuxDgk",
"live": true,
"metadata_parts": [
"5K watching"
],
"published": null,
"published_text": null,
"thumbnail": "https://i.ytimg.com/vi/pAKqJxuxDgk/hq720.jpg?v=6ab695ad&sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAsnTuz3rzGRoyMoWk--Dpn…",
"thumbnails": [
{
"height": 202,
"url": "https://i.ytimg.com/vi/pAKqJxuxDgk/hq720.jpg?v=6ab695ad&sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDiQ8g7NPCs7AsmJ6DN757_…",
"width": 360
},
{
"height": 404,
"url": "https://i.ytimg.com/vi/pAKqJxuxDgk/hq720.jpg?v=6ab695ad&sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAsnTuz3rzGRoyMoWk--Dpn…",
"width": 720
}
],
"title": "Artemis Acceleration (Oct. 23, 2026)",
"type": "video",
"upcoming": false,
"url": "https://www.youtube.com/watch?v=pAKqJxuxDgk",
"view_count": 5000,
"views": "5K watching"
},
"… 28 more"
]
} Response fields (35)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.streams | array |
$.streams[] | object | string |
$.streams[].badges | array |
$.streams[].badges[] | string |
$.streams[].channel | null |
$.streams[].channel_avatar | null |
$.streams[].channel_id | null |
$.streams[].channel_name | null |
$.streams[].channel_url | null |
$.streams[].content_type | string |
$.streams[].duration | null |
$.streams[].duration_seconds | null |
$.streams[].id | string |
$.streams[].live | boolean |
$.streams[].metadata_parts | array |
$.streams[].metadata_parts[] | string |
$.streams[].published | null | string |
$.streams[].published_text | null | string |
$.streams[].thumbnail | string |
$.streams[].thumbnails | array |
$.streams[].thumbnails[] | object |
$.streams[].thumbnails[].height | integer |
$.streams[].thumbnails[].url | string |
$.streams[].thumbnails[].width | integer |
$.streams[].title | string |
$.streams[].type | string |
$.streams[].upcoming | boolean |
$.streams[].url | string |
$.streams[].view_count | integer |
$.streams[].views | string |