Social Blade Scraper API - creator stats for YouTube, TikTok, Twitch, Instagram and Facebook

A YouTube channel page tells you how many subscribers it has right now. It tells you nothing about what it had last month. Social Blade has been writing that number down day after day, which is the only reason a 30-day or 365-day delta exists to be read at all.

This actor hands those records back as JSON: subscriber and follower counts, total views, likes, upload counts, the Social Blade grade, the rank block, growth deltas from 3 to 365 days, the daily history table, and Social Blade's own estimated-earnings range for YouTube.

It reads Social Blade's leaderboards too, so a single run can pull the top 100 YouTube channels in India, the top 100 music channels worldwide, or the top 100 Twitch streamers without you supplying a single handle.

You don't need a Social Blade account, an API key or a proxy. Do read the earnings section before you use those numbers for anything, though.

---

What you get

Three ways to ask for data, and you can mix all three in one run.

1. Named profiles — paste Social Blade URLs or platform:identifier shorthands:

{
  "profiles": [
    "https://socialblade.com/youtube/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
    "youtube:@MrBeast",
    "tiktok:khaby.lame",
    "twitch:xqc",
    "instagram:cristiano",
    "facebook:Cristiano"
  ]
}

YouTube handles, legacy usernames and channel IDs all work. Handles are resolved through Social Blade's own search, because Social Blade's channel endpoint only accepts UC… IDs.

2. Search — when you have a name but not a handle:

{ "platform": "tiktok", "searchQueries": ["khaby", "charli"], "resultsPerQuery": 5 }

3. Leaderboards — platform, platform/field, platform/field/COUNTRY, or platform/field/COUNTRY/category:

{ "topLists": ["youtube/subscribers", "youtube/views/IN", "youtube/subscribers/NONE/music", "tiktok/followers", "twitch/followers"] }

Platform	Rankable fields	Country lists	Category lists
youtube	subscribers, views, videos	yes (263 codes)	yes (16)
tiktok	followers, likes	no	no
twitch	followers	no	no
instagram	followers	no	no
facebook	likes, talking_about	no	no

YouTube categories: games, entertainment, people, animals, film, music, sports, tech, howto, news, education, comedy, nonprofit, autos, travel, shows.

---

Sample output

One row per creator. Trimmed for length:

{
  "platform": "youtube",
  "url": "https://socialblade.com/youtube/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
  "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "username": "mrbeast",
  "displayName": "MrBeast",
  "country": "US",
  "channelType": "entertainment",
  "createdAt": "2012-02-20T00:00:00.000Z",
  "grade": "A++",
  "subscribers": 512000000,
  "views": 136164217161,
  "videos": 996,
  "ranks": { "sb": 8, "subscribers": 1, "views": 6, "country": 1, "category": 1 },
  "socials": ["https://instagram.com/mrbeast", "https://twitter.com/MrBeast"],
  "growth": {
    "subscribers": { "3d": 0, "7d": 1000000, "30d": 4000000, "365d": 91000000 },
    "views": { "3d": 320744345, "7d": 829119503, "30d": 3332509053, "365d": 43319701788 },
    "videos": { "3d": 0, "7d": 0, "30d": 4, "365d": 103 }
  },
  "estimatedMonthlyEarningsUsd": { "low": 833127, "high": 13330036 },
  "estimatedYearlyEarningsUsd": { "low": 10829925, "high": 173278807 },
  "earningsNote": "ESTIMATE ONLY. Social Blade's own model: views in the window / 1,000 x $0.25-$4 RPM. Not reported revenue.",
  "listRank": null,
  "scrapedAt": "2026-08-08T20:33:36.159Z"
}

Other real values from the same day: twitch:xqc → grade B+, 12,534,003 followers, Social Blade rank 715. tiktok:khaby.lame → grade A, 162,600,000 followers, 2,700,000,000 likes, rank 1 by followers. facebook:Cristiano → grade A+, 174,448,238 likes, 3,193,612 talking about. instagram:cristiano → grade A++, 678,422,211 followers, 2.17% engagement rate, Social Blade rank 9.

Duplicate creators are removed by platform ID, so asking for youtube/subscribers and youtube/views/IN in the same run returned 178 rows rather than 200. The 22 channels on both lists were written once and charged once.

---

About the earnings figures — read this before you use them

estimatedMonthlyEarningsUsd and estimatedYearlyEarningsUsd are Social Blade's own guesses, not reported revenue, and not anything the creator has disclosed. Social Blade computes them from a flat RPM band: views in the window ÷ 1,000 × $0.25 to $4.00. Those two numbers are Social Blade's published defaults, and the range they produce is wide enough to be close to useless for a single channel. MrBeast's monthly estimate spans $833K to $13.3M.

Every row that carries them also carries earningsNote saying exactly that. They are reproduced here because people ask for the Social Blade number; treat them as a rough order of magnitude, not as revenue data. If you need real revenue, this is not the tool.

There is no per-category or per-country RPM adjustment. Social Blade does not do one, so neither does this actor.

---

Field coverage

Counted over the real top-100 leaderboard of each platform on 2026-08-08, so 500 creators in total, all 500 of which returned a full profile:

Field	YouTube	TikTok	Twitch	Instagram	Facebook
grade	100%	100%	100%	100%	100%
ranks	100%	100%	100%	100%	100%
growth (3–365d)	100%	100%	100%	0%	100%
createdAt	100%	86%	100%	0%	0%
description	96%	0%	0%	0%	0%
country	87%	0%	0%	0%	0%
website	0%	0%	0%	74%	88%
socials	30%	0%	0%	0%	0%
verified	0%	100%	100%	0%	99%
estimated earnings	100% (estimate)	n/a	n/a	n/a	n/a

A 0% means Social Blade doesn't store that field for that platform. It isn't a scraping failure, and the key is still present in the row holding a null, so your schema stays stable.

Instagram growth and Instagram daily history are 0% because Social Blade puts them behind its own paid plan and answers 401 to everyone else. The actor reports this instead of guessing.

---

What this does NOT do

• No Twitter/X. Social Blade removed its Twitter section. socialblade.com/twitter/user/<handle> returns 404 today and the API has no twitter procedure at all. There is no Twitter data on Social Blade to read. Ask for twitter:elonmusk and you get an uncharged row explaining that, not an invented number.
• No Instagram growth or Instagram history — Social Blade's paid tier, 401 for everyone else.
• No YouTube per-video data (youtube.videos, Shorts view share) — also paid tier, 401.
• Daily history is about 30 days. Ask for 365 and Social Blade still returns ~31 rows. The row reports historyDays with the true count.
• Leaderboards top out at 100 creators per list. Social Blade's API accepts limit=5000 and silently returns 100. Combine several lists (different fields, countries, categories) if you need more.
• It does not use Social Blade's paid Business API. No key of yours is used or needed.
• It only knows creators Social Blade has already indexed. A brand-new channel that nobody has ever looked up on Social Blade will come back NOT_FOUND.

---

Billing

$1.00 per 1,000 profiles, plus a $0.001 run start fee. It's a flat rate, the same number on the free plan as on any paid one.

You are charged for genuine profile rows only. Errors, blocks, not-found entries and the empty-input sample row are written to the dataset marked charged: false and cost nothing.

---

FAQ

Is there a free Social Blade API? Social Blade's own API is a paid Business product with a separate contract. This actor does not use it and does not need a key from you. It reads the same public JSON that socialblade.com's own web pages read.

How do I get a YouTube channel's subscriber count and rank? Put youtube:@handle or the channel URL into profiles. The row comes back with subscribers, views, videos, grade and a ranks object holding the Social Blade rank, subscriber rank, view rank, country rank and category rank.

Can I get the top 100 YouTube channels in a country? Yes: "topLists": ["youtube/subscribers/IN"] for India, "youtube/views/BR" for Brazil by views. 263 country codes are accepted, plus NONE for worldwide.

Are the Social Blade earnings estimates accurate? No, and Social Blade does not claim they are. They are a flat $0.25–$4.00 per 1,000 views band with no adjustment for niche, country or sponsorship. Use them as a rough bracket, nothing more. See the earnings section above.

Does it work for Twitter/X? No. Social Blade shut that section down; there is no Twitter data to read.

How fast is it? Measured on the Apify platform at 1 GB: 300 creators across three leaderboards, each with grade, ranks and full growth — 7.9 seconds. 178 creators with 30 days of daily history each — 6.4 seconds. A single leaderboard request returns 100 creators in roughly 120 ms.

Do I need a proxy? No. The actor reaches Social Blade directly from the Apify container. There is a proxy input if your account requires one, but leaving it off is both cheaper and, in testing, more reliable.

What happens if a handle does not exist? You get an uncharged diagnostic row with errorCode: "NOT_FOUND" and a hint, and the run carries on with the rest of your list.

Can I track a channel over time? Yes. Schedule the actor and each run appends a dated snapshot. growth gives you 3/7/14/30/60/90/180/365-day deltas immediately, and includeHistory adds Social Blade's own daily table for the last ~30 days.

Which platforms are supported? YouTube, TikTok, Twitch, Instagram and Facebook. Those are the five Social Blade currently publishes.