# YouTube API: Get channel > 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. Unofficial. Not affiliated with or endorsed by YouTube. - Page: https://fous.com/methods/youtube.com/get-channel - Method: `youtube.com/get_channel`, version 1 - Website: youtube.com - Returns: name, handle, description, subscribers, views, videos, join date, country, verified, links, images, channel link and 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 | |---|---|---|---|---| | `channel` | string | yes | `"MrBeast"` | Channel name, @handle, or YouTube channel link, such as MrBeast, @MrBeast, or https://www.youtube.com/@MrBeast. | ## Output From a run on Nov 1, 2026, shortened. Its input: ```json { "channel": "MrBeast" } ``` Its output: ```json { "links": [ { "link": "https://www.instagram.com/mrbeast/", "label": "Follow" }, { "link": "https://twitter.com/MrBeast", "label": "Twitter" }, { "link": "https://facebook.com/mrbeast/", "label": "Facebook" } ], "handle": "@MrBeast", "country": "United States", "verified": "yes", "join_date": "2012-02-19", "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 …", "subscribers": 524000000, "total_views": 145430387555, "channel_link": "https://www.youtube.com/@MrBeast", "channel_name": "MrBeast", "number_of_videos": 1011, "avatar_image_link": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj", "banner_image_link": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj" } ``` ## 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":"youtube.com/get_channel","input":{"channel":"MrBeast"}}' ``` 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 - Can you pull up the profile for the channel @MKBHD and tell me how many subscribers it has? - What's the join date and total view count for the Veritasium channel? - I need the description, country, and verified status of the Kurzgesagt YouTube channel. - Look up the channel at https://www.youtube.com/@LinusTechTips and list its links and video count. - Find the stats for the channel named Fireship, including subscriber total and channel ID. ## Input schema ```json { "type": "object", "required": [ "channel" ], "properties": { "channel": { "type": "string", "minLength": 1, "description": "Channel name, @handle, or YouTube channel link, such as MrBeast, @MrBeast, or https://www.youtube.com/@MrBeast." } } } ``` ## Output schema ```json { "type": "object", "required": [ "channel_name", "verified", "links", "channel_link", "channel_id" ], "properties": { "links": { "type": "array", "items": { "type": "object", "required": [ "label", "link" ], "properties": { "link": { "type": "string" }, "label": { "type": "string" } } } }, "handle": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "verified": { "enum": [ "yes", "no" ], "type": "string" }, "join_date": { "type": [ "string", "null" ] }, "channel_id": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "subscribers": { "type": [ "integer", "null" ] }, "total_views": { "type": [ "integer", "null" ] }, "channel_link": { "type": "string" }, "channel_name": { "type": "string" }, "number_of_videos": { "type": [ "integer", "null" ] }, "avatar_image_link": { "type": [ "string", "null" ] }, "banner_image_link": { "type": [ "string", "null" ] } } } ``` ## See more - [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. - [YouTube API: Find a company's channel](https://fous.com/methods/youtube.com/find-company-channel.md): Finds a company's verified YouTube channel by name and returns its name, link, subscriber count, description, country and official website when identifiable. - [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. - [YouTube API: Get video comments](https://fous.com/methods/youtube.com/get-video-comments.md): Gets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included. - [YouTube API: List top songs chart](https://fous.com/methods/youtube.com/list-top-songs.md): Lists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links. - [YouTube API: Get video transcript](https://fous.com/methods/youtube.com/get-video-transcript.md): Returns 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. - [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. - [Telegram API: Get public channel](https://fous.com/methods/t.me/get-channel.md): Gets the title, username, description, subscriber total, verification, photo and public media totals of a public Telegram channel. - [All YouTube methods](https://fous.com/methods/youtube.com.md)