Search APIs
Loading…
← API Store
Social

YouTube

YouTube

YouTube channel live streams

GET /youtube/v1/channel/lives
Test this endpoint

Every 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

NameTypeDescription
channelrequiredstring Example: @NASA
sortlatest | popular | oldestlatest (default), popular or oldest: the tab's own sort chips; next_cursor keeps the order.
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.streamsarray
$.streams[]object | string
$.streams[].badgesarray
$.streams[].badges[]string
$.streams[].channelnull
$.streams[].channel_avatarnull
$.streams[].channel_idnull
$.streams[].channel_namenull
$.streams[].channel_urlnull
$.streams[].content_typestring
$.streams[].durationnull
$.streams[].duration_secondsnull
$.streams[].idstring
$.streams[].liveboolean
$.streams[].metadata_partsarray
$.streams[].metadata_parts[]string
$.streams[].publishednull | string
$.streams[].published_textnull | string
$.streams[].thumbnailstring
$.streams[].thumbnailsarray
$.streams[].thumbnails[]object
$.streams[].thumbnails[].heightinteger
$.streams[].thumbnails[].urlstring
$.streams[].thumbnails[].widthinteger
$.streams[].titlestring
$.streams[].typestring
$.streams[].upcomingboolean
$.streams[].urlstring
$.streams[].view_countinteger
$.streams[].viewsstring