Channel Live Streams

GET/v1/youtube/channel/lives1 credit

Returns the past, current and upcoming live streams on a channel's Live tab.

01Query parameters

Name	Type	Description
handleoptional	string	Channel handle, with or without the leading `@` (e.g. `MrBeast`). One of `handle` or `channelId` is required, unless you send a `continuationToken`.
channelIdoptional	string	Channel id starting with `UC` (e.g. `UCX6OQ3DkcsbYNE6H8uQQuVA`). One of `handle` or `channelId` is required, unless you send a `continuationToken`.
continuationTokenoptional	string	The `continuationToken` from the previous page. It can be sent on its own, without the channel.
regionoptional	string	Two-letter country code that sets the YouTube region for the request (e.g. `US`, `GB`).Default: `US`

02Request

curl "https://api.scrapesocial.ai/v1/youtube/channel/lives?handle=IShowSpeed" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/youtube/channel/lives?handle=IShowSpeed

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [],
  "channels": [],
  "playlists": [],
  "shorts": [],
  "shelves": [],
  "lives": [
    {
      "type": "live",
      "id": "uQlACpbi4WM",
      "url": "https://www.youtube.com/watch?v=uQlACpbi4WM",
      "title": "SPENDING THE NIGHT IN THE WORLD'S SCARIEST HAUNTED HOUSE! 🏚️😱",
      "thumbnail": "https://i.ytimg.com/vi/uQlACpbi4WM/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBTbOYBkR9ezM1mWwFyKKJlpIvOzw",
      "channel": {
        "id": "UCWsDFcIhY2DBi3GB5uykGXA",
        "title": "IShowSpeed",
        "handle": "IShowSpeed",
        "thumbnail": "https://yt3.googleusercontent.com/ieK0j0sDqI_AHDwYxZ2Wly07-R7PG4S3YMtxOWCEe1QH-I0FgimJ92tlydQa6M78YD0VaywCaw=s160-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "88 waiting",
      "viewCountInt": 88,
      "publishedTimeText": "Scheduled for 10/26/26, 1:00 PM",
      "publishedTime": null,
      "lengthText": "Upcoming",
      "lengthSeconds": null,
      "badges": []
    },
    {
      "type": "live",
      "id": "KliV-V6SSF0",
      "url": "https://www.youtube.com/watch?v=KliV-V6SSF0",
      "title": "BUYING THE NEW iPHONE DUO!",
      "thumbnail": "https://i.ytimg.com/vi/KliV-V6SSF0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDv7yX3OJoHXjh28w-F4Ot3qM1hXg",
      "channel": {
        "id": "UCWsDFcIhY2DBi3GB5uykGXA",
        "title": "IShowSpeed",
        "handle": "IShowSpeed",
        "thumbnail": "https://yt3.googleusercontent.com/ieK0j0sDqI_AHDwYxZ2Wly07-R7PG4S3YMtxOWCEe1QH-I0FgimJ92tlydQa6M78YD0VaywCaw=s160-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "2.5M",
      "viewCountInt": 2500000,
      "publishedTimeText": "Streamed 1 day ago",
      "publishedTime": "2026-10-24T17:07:00.544Z",
      "lengthText": "2:35:28",
      "lengthSeconds": 9328,
      "badges": []
    }
  ],
  "continuationToken": "4qmFsgKdCxIYVUNXc0RGY0loWTJEQmkzR0I1dXlrR1hBGoALOGdhY0NCcVpDSEtXQ0RxVENBb2tObVF4Wm1OaVpqWXRNREF3TUMweU1qQmlMVGhqWkRFdE5EUXhNRE13TkdNMlpqVTJFdWdIUVdaelYydHNOa056VEdKYWJqWkpZMGd4ZVcxNFRERjRSa0pKVUhCQlFVVjRaWGRRV0RCM01XUkdVM2swUkRGUk1tNW5aME52VkhWR1NFOVZXWEEzZEZRdGVpMTVhRmxKZUc4M1dWWTRSMFZOYlVwTU0zb3lNMjlZUzNkbVJHcGlVWGwyTFVwMGFYTTVaMlZtUWxoVFFYSXRTWHBUY2w5elpUaFVjbUZrTjFKbk5GaHpPVEZrY1dod1FsWmhlSEpU…"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

30 streams per page, in `lives`. The answer always has six lists (`videos`, `channels`, `playlists`, `shorts`, `shelves`, `lives`) plus `continuationToken`; lists that do not apply are empty. Pass `continuationToken` back for the next page; it is null on the last page. Each item's `channel` is filled on the first page; on later pages its fields are null. Upcoming streams have no view count or duration. An unknown channel answers 404; a channel that has nothing on this tab returns the empty lists for 0 credits. A token YouTube refuses is a 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.