User Schedule

GET/v1/twitch/user/schedule1 credit

Returns a channel's stream schedule: upcoming segments with title, start and end times, categories and cancellation state, plus the channel's last broadcast, broadcast title and current stream.

01Query parameters

Name	Type	Description
handlerequired	string	The Twitch login, `@login` or a channel URL, e.g. `shroud`.

02Request

curl "https://api.scrapesocial.ai/v1/twitch/user/schedule?handle=emongg" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/twitch/user/schedule?handle=emongg

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "23220337",
  "primaryColorHex": null,
  "lastBroadcast": {
    "id": "320911183708",
    "startedAt": "2026-10-25T16:41:49.759518Z",
    "__typename": "Broadcast"
  },
  "broadcastSettings": {
    "id": "23220337",
    "title": "[OWCS !DROPS ENABLED] watching some owcs and gaming",
    "__typename": "BroadcastSettings"
  },
  "stream": {
    "id": "320911183708",
    "createdAt": "2026-10-25T16:41:43Z",
    "viewersCount": 1248,
    "previewImageURL": "https://static-cdn.jtvnw.net/previews-ttv/live_user_emongg-320x180.jpg",
    "verticalPreviewImageURL": "https://static-cdn.jtvnw.net/previews-ttv/live_user_emongg-180x320.jpg",
    "height": 1440,
    "width": 2560,
    "isDualFormat": false,
    "game": {
      "id": "515025",
      "slug": "overwatch-2",
      "name": "Overwatch",
      "__typename": "Game"
    },
    "__typename": "Stream"
  },
  "videos": {
    "edges": [
      {
        "node": {
          "id": "2910561307",
          "title": "[OWCS !DROPS ENABLED] watching some owcs and gaming",
          "createdAt": "2026-10-25T16:41:48Z",
          "lengthSeconds": 1588,
          "viewCount": 0,
          "previewThumbnailURL": "https://vod-secure.twitch.tv/_404/404_processing_320x180.png",
          "game": {
            "id": "515025",
            "slug": "overwatch-2",
            "name": "Overwatch",
            "__typename": "Game"
          },
          "__typename": "Video"
        },
        "__typename": "VideoEdge"
      },
      {
        "node": {
          "id": "2909390350",
          "title": "[OWCS !DROPS ENABLED] watching some owcs and gaming",
          "createdAt": "2026-10-24T11:56:56Z",
          "lengthSeconds": 42953,
          "viewCount": 82908,
          "previewThumbnailURL": "https://static-cdn.jtvnw.net/cf_vods/d2vi6trrdongqn/3756fd9fc0e9e26aaec0_emongg_320798703070_1792843011//thumb/thumb0-320x180.jpg",
          "game": {
            "id": "515025",
            "slug": "overwatch-2",
            "name": "Overwatch",
            "__typename": "Game"
          },
          "__typename": "Video"
        },
        "__typename": "VideoEdge"
      }
    ],
    "__typename": "VideoConnection"
  },
  "channel": {
    "id": "23220337",
    "schedule": {
      "id": "schedule-23220337",
      "nextSegment": {
        "id": "eyJzZWdtZW50SUQiOiI5NjU1NWMwMC03OGZkLTQ4NTQtYTIyZS1kYWNjOGU3ZWZlYzkiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0NH0=",
        "startAt": "2026-10-26T11:00:00Z",
        "__typename": "ScheduleSegment"
      },
      "interruption": null,
      "segments": [
        {
          "id": "eyJzZWdtZW50SUQiOiI5NjU1NWMwMC03OGZkLTQ4NTQtYTIyZS1kYWNjOGU3ZWZlYzkiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0M30=",
          "baseSegmentID": "96555c00-78fd-4854-a22e-dacc8e7efec9",
          "title": "",
          "startAt": "2026-10-19T11:00:00Z",
          "endAt": "2026-10-19T21:00:00Z",
          "isCancelled": false,
          "cancelledUntil": null,
          "hasReminder": false,
          "repeatEndsAfterCount": null,
          "categories": [],
          "__typename": "ScheduleSegment"
        },
        {
          "id": "eyJzZWdtZW50SUQiOiJiYmE3Nzk1Yi1jZWQzLTQyYzQtODNkMC02NDEyNmNjYzk5NzciLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0M30=",
          "baseSegmentID": "bba7795b-ced3-42c4-83d0-64126ccc9977",
          "title": "",
          "startAt": "2026-10-20T11:00:00Z",
          "endAt": "2026-10-20T21:00:00Z",
          "isCancelled": false,
          "cancelledUntil": null,
          "hasReminder": false,
          "repeatEndsAfterCount": null,
          "categories": [],
          "__typename": "ScheduleSegment"
        }
      ],
      "__typename": "Schedule"
    },
    "__typename": "Channel"
  },
  "__typename": "User"
}

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

The channel's fields are at the top level of the answer; the planned segments are under `channel.schedule.segments`. An unknown channel is a free 404.

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.