Social Blade API: Get YouTube channel stats
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.
Unofficial. Not affiliated with or endorsed by Social Blade.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Channel, required
channel Channel name, @handle, YouTube link, or Social Blade link, such as MrBeast or @mkbhd.
MrBeast
Input as JSON
{ "channel": "MrBeast"}Output
{ "handle": "@mrbeast", "daily_stats": [ { "date": "2026-10-10", "views": 142299869452, "subscribers": 520000000 }, { "date": "2026-10-11", "views": 142437098620, "subscribers": 521000000 }, { "date": "2026-10-12", "views": 142531876379, "subscribers": 521000000 } ], "subscribers": 523000000, "channel_name": "MrBeast", "channel_type": "Entertainment", "created_date": "2012-02-20", "subscriber_rank": 1, "number_of_videos": 1008, "earnings_currency": "USD", "social_blade_link": "https://socialblade.com/youtube/channel/UCX6OQ3DkcsbYNE6H8uQQuVA" , "total_video_views": 144115601942, "social_blade_grade": "A++", "views_gained_last_30_days": null, "estimated_yearly_earnings_range": null, "subscribers_gained_last_30_days": null, "estimated_monthly_earnings_range": null, "estimated_yearly_earnings_low_usd": null, "estimated_monthly_earnings_low_usd": null, "estimated_yearly_earnings_high_usd": null, "estimated_monthly_earnings_high_usd": null}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"socialblade.com/get_youtube_channel_stats","input":{"channel":"MrBeast"}}' # 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": "socialblade.com/get_youtube_channel_stats" , "input": { "channel": "MrBeast" }})# 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": "socialblade.com/get_youtube_channel_stats" , "input": { "channel": "MrBeast" } }), 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 socialblade.com/get_youtube_channel_stats# with {"channel":"MrBeast"}"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": { "channel": { "type": "string", "description": "Channel name, @handle, YouTube link, or Social Blade link, such as MrBeast or @mkbhd." } }}Output schema
{ "type": "object", "required": [ "channel_name", "handle", "social_blade_grade", "subscribers", "total_video_views", "number_of_videos", "channel_type", "created_date", "subscribers_gained_last_30_days", "views_gained_last_30_days", "estimated_monthly_earnings_low_usd", "estimated_monthly_earnings_high_usd", "estimated_monthly_earnings_range", "estimated_yearly_earnings_low_usd", "estimated_yearly_earnings_high_usd", "estimated_yearly_earnings_range", "earnings_currency", "subscriber_rank", "daily_stats", "social_blade_link" ], "properties": { "handle": { "type": [ "string", "null" ] }, "daily_stats": { "type": "array", "items": { "type": "object", "required": [ "date", "subscribers", "views" ], "properties": { "date": { "type": "string" }, "views": { "type": [ "integer", "null" ] }, "subscribers": { "type": [ "integer", "null" ] } }, "additionalProperties": false } }, "subscribers": { "type": [ "integer", "null" ] }, "channel_name": { "type": "string" }, "channel_type": { "type": [ "string", "null" ] }, "created_date": { "type": [ "string", "null" ] }, "subscriber_rank": { "type": [ "integer", "null" ] }, "number_of_videos": { "type": [ "integer", "null" ] }, "earnings_currency": { "type": "string" }, "social_blade_link": { "type": "string" }, "total_video_views": { "type": [ "integer", "null" ] }, "social_blade_grade": { "type": [ "string", "null" ] }, "views_gained_last_30_days": { "type": [ "integer", "null" ] }, "estimated_yearly_earnings_range": { "type": [ "string", "null" ] }, "subscribers_gained_last_30_days": { "type": [ "integer", "null" ] }, "estimated_monthly_earnings_range": { "type": [ "string", "null" ] }, "estimated_yearly_earnings_low_usd": { "type": [ "number", "null" ] }, "estimated_monthly_earnings_low_usd": { "type": [ "number", "null" ] }, "estimated_yearly_earnings_high_usd": { "type": [ "number", "null" ] }, "estimated_monthly_earnings_high_usd": { "type": [ "number", "null" ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
socialblade.com/get_youtube_channel_stats- Returns
- channel name, handle, grade, subscribers, views, videos, type, created date, 30-day growth, earnings estimates, subscriber rank, daily stats, Social Blade 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 socialblade.com/get_youtube_channel_stats with the inputs above.
Ask your agent
- How many subscribers does the channel @mkbhd have right now and how fast has it grown over the last month?
- Pull up the Social Blade stats for MrBeast, including estimated earnings and recent daily subscriber changes.
- What's the 30-day growth and estimated monthly earnings for the YouTube channel Linus Tech Tips?
- Show me the subscriber rank, total views, and video count for the channel at youtube.com/@veritasium.
- Can you look up socialblade.com stats for the YouTube creator Kurzgesagt and summarize their last 14 days of activity?
See more
All Social Blade methodsGets a TikTok creator's Social Blade profile totals, grade when shown, 30-day follower and like changes, and up to 14 days of daily totals, from a TikTok handle or a TikTok or Social Blade profile link. Counts reflect Social Blade's recorded and sometimes rounded figures.
socialblade.com/get_tiktok_statsLooks up public Instagram account totals, engagement and grade on Social Blade by handle or profile link. Daily history and 30-day follower change need a Social Blade sign-in, so they are not returned.
socialblade.com/get_instagram_statsGets 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_channelLists 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_videosFinds 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_channelGets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.
youtube.com/get_videoGets the title, username, description, subscriber total, verification, photo and public media totals of a public Telegram channel.
t.me/get_channelLooks 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_channel