YouTube API: List channel videos
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.
Unofficial. Not affiliated with or endorsed by YouTube.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Sort optional
sort Order uploads by latest or popular, such as popular.
latest
One of
latest,popular. Defaultlatest.- Type optional
type Choose videos, shorts, or live, such as shorts.
videos
One of
videos,shorts,live. Defaultvideos.- Channel, required
channel Channel name, @handle, or YouTube channel link, such as MrBeast or @MrBeast.
@MrBeast
- Max Results optional
max_results Maximum videos to return, such as 30.
30
Whole number from 1 to 200. Default
30.
Input as JSON
{ "sort": "latest", "type": "videos", "channel": "@MrBeast", "max_results": 30}Output
{ "videos": [ { "title": "Lose 150 Lbs Together, Win $250,000", "views": 130000000, "length": "43:17", "video_id": "RE3_PGwDwhw", "video_link": "https://www.youtube.com/watch?v=RE3_PGwDwhw" , "upload_date": "2026-10-18", "thumbnail_link": "https://i.ytimg.com/vi/RE3_PGwDwhw/hq720_custom_2.jpg?sqp=CMTU7NYG-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBVerhIODijwfY7jIMMu70AAQDlwA" }, { "title": "Eat Everything In A Grocery Store, Win $1,000,000", "views": 291000000, "length": "57:59", "video_id": "plN7JMbadRg", "video_link": "https://www.youtube.com/watch?v=plN7JMbadRg" , "upload_date": "2026-10-09", "thumbnail_link": "https://i.ytimg.com/vi/plN7JMbadRg/hq720_custom_1.jpg?sqp=CMTU7NYG-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLA2ZWaDkREMoDSEaABlvh9IR9CSDQ" }, { "title": "I Built A City To Save Kids From Illegal Labor", "views": 110000000, "length": "19:03", "video_id": "v9QtM6qnG50", "video_link": "https://www.youtube.com/watch?v=v9QtM6qnG50" , "upload_date": "2026-09-23", "thumbnail_link": "https://i.ytimg.com/vi/v9QtM6qnG50/hq720_custom_1.jpg?sqp=CMTU7NYG-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBA723hutZX0PMMvlM75gTFy8AXfw" } ], "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "subscribers": 523000000, "channel_link": "https://www.youtube.com/@MrBeast" , "channel_name": "MrBeast", "number_of_videos": 1000}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"youtube.com/list_channel_videos","input":{"sort":"latest","type":"videos","channel":"@MrBeast","max_results":30}}' # 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": "youtube.com/list_channel_videos" , "input": { "sort": "latest", "type": "videos", "channel": "@MrBeast", "max_results": 30 }})# 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": "youtube.com/list_channel_videos" , "input": { "sort": "latest", "type": "videos", "channel": "@MrBeast", "max_results": 30 } }), 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 youtube.com/list_channel_videos# with {"sort":"latest","type":"videos","channel":"@MrBeast","max_results":30}"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": [ "channel" ], "properties": { "sort": { "enum": [ "latest", "popular" ], "type": "string", "default": "latest", "description": "Order uploads by latest or popular, such as popular." }, "type": { "enum": [ "videos", "shorts", "live" ], "type": "string", "default": "videos", "description": "Choose videos, shorts, or live, such as shorts." }, "channel": { "type": "string", "minLength": 1, "description": "Channel name, @handle, or YouTube channel link, such as MrBeast or @MrBeast." }, "max_results": { "type": "integer", "default": 30, "maximum": 200, "minimum": 1, "description": "Maximum videos to return, such as 30." } }}Output schema
{ "type": "object", "required": [ "channel_link", "channel_id", "videos" ], "properties": { "videos": { "type": "array", "items": { "type": "object", "required": [ "video_link", "video_id" ], "properties": { "title": { "type": [ "string", "null" ] }, "views": { "type": [ "integer", "null" ] }, "length": { "type": [ "string", "null" ] }, "video_id": { "type": "string" }, "video_link": { "type": "string" }, "upload_date": { "type": [ "string", "null" ] }, "thumbnail_link": { "type": [ "string", "null" ] } } } }, "channel_id": { "type": "string" }, "subscribers": { "type": [ "integer", "null" ] }, "channel_link": { "type": "string" }, "channel_name": { "type": [ "string", "null" ] }, "number_of_videos": { "type": [ "integer", "null" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
youtube.com/list_channel_videos- Returns
- channel name, subscribers, video count, channel link and id, videos (title, views, date, length, thumbnail, link)
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 youtube.com/list_channel_videos with the inputs above.
Ask your agent
- What are the most popular Shorts on the MrBeast channel right now?
- Show me the latest live streams from @LinusTechTips with view counts and dates.
- List the 15 most viewed regular videos from the Veritasium channel on YouTube.
- Get the newest uploads from the Kurzgesagt channel, including thumbnails and video lengths.
- I need the channel's subscriber count plus its 50 latest videos for @mkbhd.
See more
All YouTube methodsGets 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_channelGets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included.
youtube.com/get_video_commentsGets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
youtube.com/get_videoLists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links.
youtube.com/list_top_songsFinds a company's verified YouTube channel by name and returns its name, link, subscriber count, description, country and official website when identifiable.
youtube.com/find_company_channelReturns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned.
youtube.com/get_video_transcriptLists 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 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_stats