Twitch API: List top categories
Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
Unofficial. Not affiliated with or endorsed by Twitch.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Max Results optional
max_results Maximum number of categories to return, for example 25.
25 (default)
Whole number from 1 to 100.
Input as JSON
{}Output
{ "categories": [ { "rank": 1, "tags": [ "IRL" ], "category_id": "509658", "category_link": "https://www.twitch.tv/directory/category/just-chatting" , "category_name": "Just Chatting", "box_art_image_link": "https://static-cdn.jtvnw.net/ttv-boxart/509658-300x400.jpg" , "current_live_viewers": 184103 }, { "rank": 2, "tags": [ "RPG", "Strategy", "MOBA" ], "category_id": "21779", "category_link": "https://www.twitch.tv/directory/category/league-of-legends" , "category_name": "League of Legends", "box_art_image_link": "https://static-cdn.jtvnw.net/ttv-boxart/21779-300x400.jpg" , "current_live_viewers": 99782 }, { "rank": 3, "tags": [ "Strategy", "MOBA", "Action" ], "category_id": "29595", "category_link": "https://www.twitch.tv/directory/category/dota-2" , "category_name": "Dota 2", "box_art_image_link": "https://static-cdn.jtvnw.net/ttv-boxart/29595-300x400.jpg" , "current_live_viewers": 59910 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"twitch.tv/list_top_categories","input":{}}' # 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/list_top_categories" , "input": {}})# 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/list_top_categories" , "input": {} }), 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/list_top_categories# with {}"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": [], "properties": { "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum number of categories to return, for example 25." } }}Output schema
{ "type": "object", "required": [ "categories" ], "properties": { "categories": { "type": "array", "items": { "type": "object", "required": [ "rank", "category_name", "current_live_viewers", "tags", "box_art_image_link", "category_link", "category_id" ], "properties": { "rank": { "type": "integer", "description": "Position by live viewers, highest first." }, "tags": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "Category content tags." }, "category_id": { "type": [ "string", "null" ], "description": "Twitch category ID." }, "category_link": { "type": [ "string", "null" ], "description": "Twitch category page link." }, "category_name": { "type": [ "string", "null" ], "description": "Name of the game or category." }, "box_art_image_link": { "type": [ "string", "null" ], "description": "Box art image link." }, "current_live_viewers": { "type": [ "integer", "null" ], "description": "People watching the category live now." } }, "additionalProperties": false }, "description": "Top categories in descending viewer order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
twitch.tv/list_top_categories- Returns
- rank, category name, live viewers, tags, box art, category link, category ID
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/list_top_categories with the inputs above.
Ask your agent
- What are the top 25 most watched games on Twitch right now by live viewers?
- Show me the current top categories ranked by viewer count, with their tags and box art
- I need a ranked list of the 10 biggest Twitch categories at the moment, including category links and IDs
- Which games have the most live viewers on twitch.tv today? Give me the top 50
- Pull the leading streaming categories by current audience, with rank, viewer numbers and box art images
See more
All Twitch methodsLists 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 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_videosLooks 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.tv/get_channelReturns 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 Kick streams right now, optionally in one category and language, sorted by current viewers.
kick.com/list_live_streamsLists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
similarweb.com/list_top_websitesLists the current Bilibili ranking overall or in a selected category, in rank order. The Movies ranking does not provide uploader, likes, length or BV numbers.
bilibili.com/list_popular_videosLists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.
coingecko.com/list_crypto_categories