# Twitch API: Get a channel

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

Unofficial. Not affiliated with or endorsed by Twitch.

- Page: https://fous.com/methods/twitch.tv/get-channel
- Method: `twitch.tv/get_channel`, version 1
- Website: twitch.tv
- Returns: profile, followers, partner status, live stream status, recent videos
- 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 |
|---|---|---|---|---|
| `streamer` | string | yes | `"kaicenat"` | The channel name, display name, or Twitch channel link, for example kaicenat, Kai Cenat, or https://www.twitch.tv/kaicenat. |

## Output

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

```json
{
  "streamer": "kaicenat"
}
```

Its output:

```json
{
  "status": "Partner",
  "videos": [
    {
      "date": "2026-10-23",
      "link": "https://www.twitch.tv/videos/2908142170",
      "title": "UNBOXING IPHONE DUO + EXPLORING KYOTO JAPAN🇯🇵",
      "views": 12593,
      "length": "3h 59m 24s"
    },
    {
      "date": "2026-10-22",
      "link": "https://www.twitch.tv/videos/2907224886",
      "title": "RETURNING TO JAPAN W/ RAY🇯🇵",
      "views": 2407585,
      "length": "5h 36m 0s"
    },
    {
      "date": "2026-10-15",
      "link": "https://www.twitch.tv/videos/2901714894",
      "title": "BUILDING A TREEHOUSE WITH AMP",
      "views": 1128148,
      "length": "3h 2m 17s"
    }
  ],
  "category": null,
  "language": null,
  "live_now": false,
  "followers": 21897573,
  "channel_id": "641972806",
  "started_at": null,
  "description": null,
  "channel_link": "https://www.twitch.tv/kaicenat",
  "display_name": "KaiCenat",
  "stream_title": null,
  "current_viewers": null,
  "profile_image_link": "https://static-cdn.jtvnw.net/jtv_user_pictures/bf6a04cf-3f44-4986-8eed-5c36bfad542b-profile_image-300x300.png"
}
```

## 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_channel","input":{"streamer":"kaicenat"}}'
```

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

- Is shroud live right now on Twitch?
- Show me the profile and follower count for the channel pokimane
- Check whether the streamer ninja is currently broadcasting and list their latest VODs
- Find the Twitch channel at https://www.twitch.tv/xqc and tell me if it's a partner
- What are the 10 most recent videos from the channel named Amouranth?

## Input schema

```json
{
  "type": "object",
  "required": [
    "streamer"
  ],
  "properties": {
    "streamer": {
      "type": "string",
      "description": "The channel name, display name, or Twitch channel link, for example kaicenat, Kai Cenat, or https://www.twitch.tv/kaicenat."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "display_name",
    "followers",
    "status",
    "description",
    "profile_image_link",
    "channel_link",
    "live_now",
    "stream_title",
    "category",
    "current_viewers",
    "started_at",
    "language",
    "videos",
    "channel_id"
  ],
  "properties": {
    "status": {
      "enum": [
        "Partner",
        "Affiliate",
        "Neither"
      ],
      "type": "string",
      "description": "Twitch partner or affiliate status."
    },
    "videos": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "date",
          "views",
          "length",
          "link"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Video publication date."
          },
          "link": {
            "type": "string",
            "description": "Twitch video page link."
          },
          "title": {
            "type": "string",
            "description": "Video title."
          },
          "views": {
            "type": "integer",
            "description": "Video view count."
          },
          "length": {
            "type": "string",
            "description": "Video duration as readable text."
          }
        }
      },
      "description": "Up to 10 recent broadcast videos, newest first."
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current game or category, if live."
    },
    "language": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current stream language, if live."
    },
    "live_now": {
      "type": "boolean",
      "description": "Whether the channel is broadcasting now."
    },
    "followers": {
      "type": "integer",
      "description": "Follower count."
    },
    "channel_id": {
      "type": "string",
      "description": "Twitch channel ID."
    },
    "started_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current stream start time as ISO 8601 with offset, if live."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Channel description, if present."
    },
    "channel_link": {
      "type": "string",
      "description": "Twitch channel page link."
    },
    "display_name": {
      "type": "string",
      "description": "Channel display name."
    },
    "stream_title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current stream title, if live."
    },
    "current_viewers": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Current stream viewers, if live."
    },
    "profile_image_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Channel profile image link."
    }
  }
}
```

## See more

- [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 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.
- [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.
- [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.
- [Social Blade API: Get YouTube channel stats](https://fous.com/methods/socialblade.com/get-youtube-channel-stats.md): Looks up a YouTube channel on Social Blade by name, @handle, YouTube link or Social Blade link and returns its profile, 30-day growth, earnings estimates and the last 14 daily statistics.
- [TikTok API: Get profile](https://fous.com/methods/tiktok.com/get-profile.md): Gets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned.
- [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)
