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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Streamer, required
streamer The channel name, display name, or Twitch channel link, for example kaicenat, Kai Cenat, or https://www.twitch.tv/kaicenat.
kaicenat
Input as JSON
{ "streamer": "kaicenat"}Output
{ "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" }Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "twitch.tv/get_channel" , "input": { "streamer": "kaicenat" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "twitch.tv/get_channel" , "input": { "streamer": "kaicenat" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run twitch.tv/get_channel# with {"streamer":"kaicenat"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
twitch.tv/get_channel- Returns
- profile, followers, partner status, live stream status, recent videos
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method twitch.tv/get_channel with the inputs above.
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?
See more
All Twitch methodsLists 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.tv/list_channel_videosReturns 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.tv/get_stream_scheduleLists 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.tv/list_top_streamsLists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
twitch.tv/list_top_categoriesGets a public YouTube channel's profile, links and statistics from its name, @handle or link. Subscriber totals may be rounded as YouTube displays them.
youtube.com/get_channelLooks 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.
socialblade.com/get_youtube_channel_statsGets 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.
tiktok.com/get_profileLists 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.
youtube.com/list_channel_videos