Social Blade Scraper: creator stats, grade, rank and growth as JSON

Give it handles, Social Blade links or a leaderboard name, and each creator comes back as one row: subscriber and follower counts, views, likes, upload counts, the Social Blade grade, the rank block, and growth over 3 to 365 days. YouTube, TikTok, Twitch, Instagram and Facebook.

Growth is the reason to use it. A channel page tells you the count today and nothing about last month. Social Blade has been writing that number down daily for years, and that record is what the deltas are read from. Two things it will not give you, whatever you ask: Instagram growth and history, which Social Blade keeps behind its own paid plan, and anything about Twitter or X, whose section Social Blade shut down.

Input	Handles, Social Blade links, search names or leaderboards
Output	One row per creator
Ceiling	5,000 rows per run, and 100 creators per leaderboard
Account needed	None, and no Social Blade key
Price	$1.00 per 1,000 profiles, flat on every plan

📊 What Social Blade Scraper does

There are three ways to ask, and one run can mix all three.

Named profiles. Paste Social Blade URLs, or the short form youtube:@MrBeast, tiktok:khaby.lame, twitch:xqc, instagram:cristiano, facebook:Cristiano. YouTube handles, legacy usernames and UC… channel ids all work.

Search. When you have a name and not a handle, put it in Search queries and pick the platform.

Leaderboards. youtube/subscribers, youtube/views/IN, youtube/subscribers/NONE/music, tiktok/followers, twitch/followers. One run can pull the top 100 channels in a country or a category without you supplying a single handle.

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

The same creator asked for twice, once by handle and once through a leaderboard, is written and billed once.

📥 What you give it

{
  "profiles": ["youtube:@MrBeast", "tiktok:khaby.lame", "twitch:xqc"],
  "includeGrowth": true,
  "maxItems": 100
}

Field	Default	What it is
profiles	none, the form starts with three examples	Social Blade URLs, or platform:identifier. A bare handle uses the platform set below.
searchQueries	none	Creator names to search on the chosen platform.
topLists	none	Leaderboards, as platform, platform/field, platform/field/COUNTRY or platform/field/COUNTRY/category.
platform	youtube	Used for bare handles and for every search query.
maxItems	100	Cap on charged rows for the whole run, up to 5,000.
topListSize	100	Creators to take from each leaderboard. 100 is Social Blade's own ceiling, and asking for more is cut back to it.
resultsPerQuery	5	Matches to keep per search query, up to 20.
includeGrowth	true	The 3, 7, 14, 30, 60, 90, 180 and 365 day deltas. YouTube earnings estimates come from these, so switching it off removes those too.
includeHistory	false	The day by day table.
historyDays	30	How many days of it to ask for. Social Blade serves about 30 to visitors without an account, whatever you set.
enrichTopLists	true	Fetch the full profile for each creator on a leaderboard. Leaderboard payloads leave out the grade and rank block, so turning this off gives a faster run with fewer fields.
proxyConfiguration	off	Optional. Only your own server URLs are used here.

📤 What you get back

A real row from a recent run. Twitch keeps far fewer fields than YouTube, and the nulls below are what that looks like:

{
  "platform": "twitch",
  "query": "twitch:xqc",
  "url": "https://socialblade.com/twitch/user/xqc",
  "id": "71092938",
  "username": "xqc",
  "displayName": "xQc",
  "avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/xqc-profile_image-9298dca608632101-300x300.jpeg",
  "country": null,
  "verified": true,
  "createdAt": "2014-09-12T00:00:00.000Z",
  "grade": "A",
  "subscribers": null,
  "followers": 12565153,
  "views": null,
  "videos": null,
  "statsHidden": false,
  "ranks": { "sb": 119, "followers": 6 },
  "growth": {
    "followers": {
      "3d": 3027, "7d": 8233, "14d": 19959, "30d": 29261,
      "60d": 36160, "90d": 62328, "180d": 231269, "365d": 397067
    }
  },
  "listRank": null,
  "listName": null,
  "resolvedVia": "direct",
  "scrapedAt": "2026-09-20T07:05:49.112Z"
}

Field	What it is
grade	Social Blade's letter grade, from A++ down.
ranks	Social Blade's overall rank plus the per-metric, country and category ranks where the platform has them.
growth	Per metric, the change over 3, 7, 14, 30, 60, 90, 180 and 365 days.
history	With daily history on, a dated row per day with that day's counts, plus historyDays giving the real number returned.
resolvedVia	How the creator was found: direct, search-exact, search-best, search, top-list or top-list-lite.
listRank, listName	Set when the row came from a leaderboard.
socials	Other accounts the creator links to. YouTube only, and on under a third of rows.
estimatedMonthlyEarningsUsd, estimatedYearlyEarningsUsd, earningsNote	YouTube only. Read the section below before using them.

Coverage counted over the real top 100 of each platform on 8 August 2026, 500 creators in total:

Field	YouTube	TikTok	Twitch	Instagram	Facebook
grade, ranks	100%	100%	100%	100%	100%
growth	100%	100%	100%	0%	100%
createdAt	100%	86%	100%	0%	0%
country	87%	0%	0%	0%	0%
website	0%	0%	0%	74%	88%
verified	0%	100%	100%	0%	99%

A zero means Social Blade does not keep that field for that platform. The key is still in the row holding a null, so your schema stays the same shape across platforms.

🧾 Reading the output

Row	How to spot it	Charged
A creator	Neither _sample nor _diagnostic on it	yes
The sample row	_sample: true, and charged: false	no
A diagnostic	_diagnostic: true with an errorCode and a hint	no

Start the actor with nothing filled in and you get the sample row, so you can see the shape first.

Code	What it means
BAD_INPUT	The entry could not be read, for example a twitter: handle, which Social Blade no longer covers.
NOT_FOUND	Social Blade has never indexed that creator.
PAID_TIER	The data exists but sits behind Social Blade's own paid plan. Instagram growth and history land here.
NO_RESULTS	A search matched nobody.
BLOCKED, BAD_REQUEST, API_ERROR, ERROR	Social Blade answered badly. Run it again.

One gap to know about: a named profile that fails gets its own diagnostic row, but a creator that fails inside a search or a leaderboard does not. That list just comes back a row or two short.

▶️ How to run it

1. Open Social Blade Scraper and click Try for free.
2. Put handles or links into Profiles, or a leaderboard like youtube/subscribers into Top lists.
3. Set Max profiles, and switch on Include daily history if you want the day by day table.
4. Click Start.
5. Download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$1.00 per 1,000 profiles. Flat on every Apify plan, no volume tiers.

You pay per creator row delivered. The sample row and diagnostic rows carry charged: false and are not billed, and a creator returned by two of your inputs is billed once.

💡 What people use it for

• Checking a creator's 30 and 365 day growth before paying for a sponsorship, rather than trusting a screenshot of today's count.
• Pulling the top 100 of a country or a category and sorting it by growth instead of by size.
• Tracking a set of channels weekly and writing each run into a sheet, so the trend is yours to keep.
• Comparing one creator across platforms in a single run.
• Screening an influencer list: grade, rank and a year of growth in one row each.

💵 About the earnings figures

estimatedMonthlyEarningsUsd and estimatedYearlyEarningsUsd are Social Blade's own estimates, not reported revenue and not anything a creator has disclosed. Social Blade works them out from a flat band of between $0.25 and $4.00 per thousand views, with no adjustment for niche, country or sponsorship, so the low and high ends can be a factor of sixteen apart. Every row carrying them also carries earningsNote saying exactly that.

They are here because people ask for the Social Blade number. Treat them as a rough bracket. For real revenue, this is the wrong tool.

🚧 What it does not do

• No Twitter or X. Social Blade removed that section. Asking for one gets an uncharged row saying so rather than an invented number.
• No Instagram growth and no Instagram daily history. Social Blade's own paid plan.
• No YouTube per-video data. Also paid.
• Daily history is about 30 days, whatever you set. The row reports the real count.
• Leaderboards stop at 100 creators each. Combine several lists for more.
• Only creators Social Blade already indexed. A brand new channel nobody has looked up comes back NOT_FOUND.
• Max profiles is applied as rows are written, so a large run with several requests in flight can land a handful of rows over the cap.
• Numbers are Social Blade's, read from its records, not from each platform's own API.

🧭 Which creator scraper do you need?

If you want	Use
Grade, rank and 3 to 365 day growth across five platforms	This one
A YouTube channel's live details and video list	YouTube Channel Scraper
A TikTok account's live profile and videos	TikTok User Scraper
Instagram profiles with exact follower counts and bio links	Instagram Profile Scraper
An X account's profile and recent posts	Twitter (X) User Scraper

❓ Questions people ask

Do I need a Social Blade account or key? No. This reads the same public data the site's own pages read.

Can I get the top 100 YouTube channels in one country? Yes. youtube/subscribers/IN for India by subscribers, youtube/views/BR for Brazil by views, NONE in that slot for worldwide.

Are the earnings estimates accurate? No, and Social Blade does not claim they are. See the section above.

What happens if a handle does not exist? You get an uncharged 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 it and each run appends a dated snapshot. growth already gives you the deltas on the first run.

Why is Instagram missing its growth numbers? Social Blade keeps Instagram growth and history for its paying customers. The row says PAID_TIER instead of guessing.

Is this legal? These are public creator statistics on a public site. Apify's write-up on scraping and the law is a good start, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the handle or leaderboard you used and the run ID. The errorCode and hint on the diagnostic row usually name the problem.