# Twitch API: Get channel stream schedule

> Returns a Twitch channel's public upcoming stream schedule for the next 1 to 30 days, with start and end times, titles, categories and cancellations.

Unofficial. Not affiliated with or endorsed by Twitch.

- Page: https://fous.com/methods/twitch.tv/get-stream-schedule
- Method: `twitch.tv/get_stream_schedule`, version 1
- Website: twitch.tv
- Returns: channel name, schedule link, vacation note, upcoming streams
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `channel` | string | yes | `"https://www.twitch.tv/cohhcarnage/schedule"` | Twitch channel name or channel link, for example lirik or https://www.twitch.tv/lirik/schedule. |
| `days_ahead` | integer | no | `30` | Number of days ahead to include, for example 14. Default 7. Default 7. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "channel": "https://www.twitch.tv/cohhcarnage/schedule",
  "days_ahead": 30
}
```

Its output:

```json
{
  "channel": "CohhCarnage",
  "streams": [
    {
      "link": "https://www.twitch.tv/cohhcarnage/schedule",
      "title": "Normal Stream!",
      "end_at": "2026-10-23T19:00:00+00:00",
      "category": null,
      "start_at": "2026-10-23T12:00:00+00:00",
      "cancelled": false,
      "recurring": true
    },
    {
      "link": "https://www.twitch.tv/cohhcarnage/schedule",
      "title": "Saturday Stream!",
      "end_at": "2026-10-24T16:00:00+00:00",
      "category": null,
      "start_at": "2026-10-24T12:00:00+00:00",
      "cancelled": false,
      "recurring": true
    },
    {
      "link": "https://www.twitch.tv/cohhcarnage/schedule",
      "title": "Reruns in our 24 Hour Community, Twitch.tv/Cohh!",
      "end_at": "2026-10-24T23:00:00+00:00",
      "category": null,
      "start_at": "2026-10-24T19:00:00+00:00",
      "cancelled": false,
      "recurring": true
    }
  ],
  "schedule_link": "https://www.twitch.tv/cohhcarnage/schedule",
  "vacation_note": null
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"twitch.tv/get_stream_schedule","input":{"channel":"https://www.twitch.tv/cohhcarnage/schedule","days_ahead":30}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is xQcOW's stream schedule for the next 14 days?
- Show me upcoming streams from the channel pokimane this week, including cancellations.
- Can you check when shroud is streaming in the next 3 days on Twitch?
- I want to see the schedule for the channel https://www.twitch.tv/ninja/schedule over the next 30 days.
- Which categories and titles does the streamer lirik have planned for the coming week, and is there any vacation note?

## Input schema

```json
{
  "type": "object",
  "required": [
    "channel"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Twitch channel name or channel link, for example lirik or https://www.twitch.tv/lirik/schedule."
    },
    "days_ahead": {
      "type": "integer",
      "default": 7,
      "maximum": 30,
      "minimum": 1,
      "description": "Number of days ahead to include, for example 14. Default 7."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "channel",
    "schedule_link",
    "vacation_note",
    "streams"
  ],
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel display name."
    },
    "streams": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "start_at",
          "end_at",
          "title",
          "category",
          "recurring",
          "cancelled",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string",
            "description": "Stream schedule page."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Scheduled stream title, if provided."
          },
          "end_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stream end time in ISO 8601 with offset, if provided."
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Scheduled category, if provided."
          },
          "start_at": {
            "type": "string",
            "description": "Stream start time in ISO 8601 with offset."
          },
          "cancelled": {
            "type": "boolean",
            "description": "Whether the stream was cancelled."
          },
          "recurring": {
            "type": "boolean",
            "description": "Whether the scheduled slot repeats weekly."
          }
        },
        "additionalProperties": false
      },
      "description": "Upcoming scheduled streams in start-time order."
    },
    "schedule_link": {
      "type": "string",
      "description": "Public channel schedule page."
    },
    "vacation_note": {
      "type": [
        "string",
        "null"
      ],
      "description": "Scheduled vacation note, if any."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Twitch API: Get a channel](https://fous.com/methods/twitch.tv/get-channel.md): Looks up a public Twitch channel by name, display name or channel link and returns its profile, live status and up to 10 recent broadcast videos.
- [Twitch API: List channel videos](https://fous.com/methods/twitch.tv/list-channel-videos.md): Lists a Twitch channel's public past broadcasts or highlights by date, or its top clips by views for a chosen period. Returns up to 100 items; clips unavailable to anonymous viewers are not included.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [AniList API: Get airing schedule](https://fous.com/methods/anilist.co/get-airing-schedule.md): Lists upcoming AniList anime episodes ordered by air time, with air times in the chosen time zone and available streaming links.
- [YouTube API: Get channel](https://fous.com/methods/youtube.com/get-channel.md): Gets a public YouTube channel's profile, links and statistics from its name, @handle or link. Subscriber totals may be rounded as YouTube displays them.
- [Kick API: List live streams](https://fous.com/methods/kick.com/list-live-streams.md): Lists the most-watched live Kick streams right now, optionally in one category and language, sorted by current viewers.
- [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate.
- [All Twitch methods](https://fous.com/methods/twitch.tv.md)