# Twitch API: List top streams

> 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.

Unofficial. Not affiliated with or endorsed by Twitch.

- Page: https://fous.com/methods/twitch.tv/list-top-streams
- Method: `twitch.tv/list_top_streams`, version 1
- Website: twitch.tv
- Returns: rank, streamer, title, category, viewers, language, start time, thumbnail, channel link
- 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 |
|---|---|---|---|---|
| `category` | string | no | `"Fortnite"` | Game or category name, such as Fortnite or Just Chatting. Leave blank for all categories. Default "". |
| `language` | string | no | `"English"` | Stream language name or two-letter code, such as English or es. Leave blank for all languages. Default "". |
| `max_results` | integer | no | `25` | Maximum number of streams, such as 25. Default 25. |

## Output

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

```json
{
  "category": "Fortnite",
  "language": "English",
  "max_results": 25
}
```

Its output:

```json
{
  "streams": [
    {
      "rank": 1,
      "category": "Fortnite",
      "language": "English",
      "started_at": "2026-10-23T07:03:56+00:00",
      "channel_link": "https://www.twitch.tv/loeya",
      "stream_title": "FRIYAY chat chooses my fits! - !corsair - Code: LOEYA #EpicPartner",
      "streamer_name": "Loeya",
      "thumbnail_link": "https://static-cdn.jtvnw.net/previews-ttv/live_user_loeya-640x360.jpg",
      "current_viewers": 1499
    },
    {
      "rank": 2,
      "category": "Fortnite",
      "language": "English",
      "started_at": "2026-10-23T06:01:43+00:00",
      "channel_link": "https://www.twitch.tv/oatley",
      "stream_title": "🏆 SOLO RELOAD VICTORY CUP FINALS 🏆 !map",
      "streamer_name": "Oatley",
      "thumbnail_link": "https://static-cdn.jtvnw.net/previews-ttv/live_user_oatley-640x360.jpg",
      "current_viewers": 1048
    },
    {
      "rank": 3,
      "category": "Fortnite",
      "language": "English",
      "started_at": "2026-10-23T02:07:26+00:00",
      "channel_link": "https://www.twitch.tv/blou",
      "stream_title": "Not Ending Till I Win A game of Fortnite B lou Gaming",
      "streamer_name": "BLOU",
      "thumbnail_link": "https://static-cdn.jtvnw.net/previews-ttv/live_user_blou-640x360.jpg",
      "current_viewers": 838
    }
  ]
}
```

## 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/list_top_streams","input":{"category":"Fortnite","language":"English","max_results":25}}'
```

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 are the most-watched live streams on Twitch right now?
- Show me the top 10 Fortnite streams currently live, with viewer counts.
- Which Spanish-language streams have the biggest audiences at the moment?
- List the 50 biggest live Just Chatting broadcasts and their start times.
- Give me the current top streams across all categories in English, limited to 30.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "default": "",
      "description": "Game or category name, such as Fortnite or Just Chatting. Leave blank for all categories."
    },
    "language": {
      "type": "string",
      "default": "",
      "description": "Stream language name or two-letter code, such as English or es. Leave blank for all languages."
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of streams, such as 25."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "streams"
  ],
  "properties": {
    "streams": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "streamer_name",
          "stream_title",
          "category",
          "current_viewers",
          "language",
          "started_at",
          "thumbnail_link",
          "channel_link"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "type": [
              "string",
              "null"
            ]
          },
          "started_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "channel_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "stream_title": {
            "type": [
              "string",
              "null"
            ]
          },
          "streamer_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "thumbnail_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "current_viewers": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [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.
- [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: 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: Get channel stream schedule](https://fous.com/methods/twitch.tv/get-stream-schedule.md): 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.
- [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.
- [Spotify API: List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md): Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.
- [Steam API: List most played games](https://fous.com/methods/store.steampowered.com/list-most-played.md): Lists the games with the most players on Steam right now, with current and peak players and prices for a chosen country.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [All Twitch methods](https://fous.com/methods/twitch.tv.md)