# Twitch API: List channel videos > 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. Unofficial. Not affiliated with or endorsed by Twitch. - Page: https://fous.com/methods/twitch.tv/list-channel-videos - Method: `twitch.tv/list_channel_videos`, version 1 - Website: twitch.tv - Returns: title, date, length, views, category, thumbnail link, video link, id - 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 | |---|---|---|---|---| | `type` | string | no | | Which videos to list: past_broadcasts, highlights, or clips. One of "past_broadcasts", "highlights", "clips". Default "past_broadcasts". | | `channel` | string | yes | `"xQc"` | Twitch channel name or channel link, for example xQc or https://www.twitch.tv/xqc. | | `clip_period` | string | no | | Period for top clips only, for example last_week. One of "last_day", "last_week", "last_month", "all_time". Default "last_week". | | `max_results` | integer | no | | Maximum number of items, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "channel": "xQc" } ``` Its output: ```json { "videos": [ { "id": "2907859259", "date": "2026-10-22", "title": "🚓LIVE🚓CLICK🚓DRAMA🚓GTA V🚓NOPIXEL V🚓MEGA ULTRA SUPER DAY🚓LOCK IT IN🚓TURF DAY🚓CAR DAY🚓END TIMES DAY🚓COOL🚓", "views": 19551, "length": "13:05:34", "category": "Just Chatting", "video_link": "https://www.twitch.tv/videos/2907859259", "thumbnail_link": "https://static-cdn.jtvnw.net/cf_vods/d2vi6trrdongqn/03c6bbf4dff92859742c_xqc_320774646110_1792695855//thumb/thumb0-320x180.jpg" }, { "id": "2907037919", "date": "2026-10-21", "title": "🌫️LIVE🌫️CLICK🌫️GTA V🌫️NOPIXEL V🌫️MEGA DAY🌫️IMPORTANT🌫️LOCK IN🌫️CAR DAY????🌫️WOAH🌫️LETS GET IT🌫️BUSTA🌫️YAY🌫️", "views": 805698, "length": "11:55:06", "category": "Just Chatting", "video_link": "https://www.twitch.tv/videos/2907037919", "thumbnail_link": "https://static-cdn.jtvnw.net/cf_vods/d1m7jfoe9zdc1j/e703c7899ad0c6a9d661_xqc_322064727131_1792612570//thumb/thumb0-320x180.jpg" }, { "id": "2905320411", "date": "2026-10-19", "title": "🌞LIVE🌞CLICK🌞DRAMA🌞NEWS🌞GTA V🌞NOPIXEL V🌞BIG UPDATE🌞I THINK🌞MEGA NEWS🌞IMPORTANT🌞SUPER DAY LOCK IN🌞CAR PART STACKING🌞", "views": 833038, "length": "11:38:10", "category": "Just Chatting", "video_link": "https://www.twitch.tv/videos/2905320411", "thumbnail_link": "https://static-cdn.jtvnw.net/cf_vods/d1m7jfoe9zdc1j/a1033b5ad1de49dc3e4f_xqc_322039747803_1792439761//thumb/thumb0-320x180.jpg" } ], "channel": "xQc" } ``` ## 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_channel_videos","input":{"channel":"xQc"}}' ``` 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 - Show me the top clips from the last month for the channel shroud, up to 50 of them - I want past broadcasts from xQc, sorted by date, just 10 results - Can you list highlights from the channel https://www.twitch.tv/pokimane? - What are the most viewed clips of all time for ninja on Twitch? - Pull up the last 30 past streams from the channel Asmongold so I can see their lengths and categories ## Input schema ```json { "type": "object", "required": [ "channel" ], "properties": { "type": { "enum": [ "past_broadcasts", "highlights", "clips" ], "type": "string", "default": "past_broadcasts", "description": "Which videos to list: past_broadcasts, highlights, or clips." }, "channel": { "type": "string", "description": "Twitch channel name or channel link, for example xQc or https://www.twitch.tv/xqc." }, "clip_period": { "enum": [ "last_day", "last_week", "last_month", "all_time" ], "type": "string", "default": "last_week", "description": "Period for top clips only, for example last_week." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of items, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "channel", "videos" ], "properties": { "videos": { "type": "array", "items": { "type": "object", "required": [ "title", "date", "length", "views", "category", "thumbnail_link", "video_link", "id" ], "properties": { "id": { "type": "string", "description": "Twitch video or clip ID." }, "date": { "type": [ "string", "null" ], "format": "date", "description": "Publication date." }, "title": { "type": [ "string", "null" ], "description": "Video or clip title." }, "views": { "type": [ "integer", "null" ], "description": "View count." }, "length": { "type": [ "string", "null" ], "description": "Duration as text." }, "category": { "type": [ "string", "null" ], "description": "Game or category name." }, "video_link": { "type": "string", "description": "Twitch page for this video or clip." }, "thumbnail_link": { "type": [ "string", "null" ], "description": "Thumbnail image link." } }, "additionalProperties": false }, "description": "Past broadcasts or highlights newest first; clips most viewed first." }, "channel": { "type": "string", "description": "Channel display name." } }, "additionalProperties": false } ``` ## See more - [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: 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. - [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: 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. - [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. - [Telegram API: List channel posts](https://fous.com/methods/t.me/list-channel-posts.md): Lists the latest posts from a public Telegram channel preview, with text, posting time, approximate views, edit flag, forwarded source, thumbnails and post links. - [YouTube API: Get video](https://fous.com/methods/youtube.com/get-video.md): Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match. - [All Twitch methods](https://fous.com/methods/twitch.tv.md)