Social Blade Scraper API - YouTube, TikTok, Twitch Stats

Give it creator handles, Social Blade links or a leaderboard name and get each creator 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. 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: counts, grade, ranks, 3 to 365 day growth, optional daily history, and Social Blade's own YouTube earnings estimate
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 on the Free plan, a little less on paid plans. The free plan's $5 a month covers about 5,000

🔍 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 data you get from each creator

What you get	Field
Platform, what you asked for, and the Social Blade page	platform, query, url
The creator's id, handle and display name	id, username, displayName
Avatar, banner, description and website	avatar, banner, description, website
Country, verified flag and join date	country, verified, createdAt
Subscribers, followers, following, likes, views and uploads	subscribers, followers, following, likes, views, videos, mediaCount, talkingAbout
Engagement figures where the platform has them	engagementRate, averageLikes, averageComments
Social Blade's grade and ranks	grade, ranks
Change over 3, 7, 14, 30, 60, 90, 180 and 365 days	growth
The day-by-day table, when switched on	history, historyDays
Leaderboard position, when the row came from one	listRank, listName
How the creator was found	resolvedVia
Other accounts the creator links to (YouTube only)	socials
Social Blade's earnings estimate (YouTube only)	estimatedMonthlyEarningsUsd, estimatedYearlyEarningsUsd, earningsNote

▶️ How to scrape Social Blade stats

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.

Start it with nothing filled in and you get one labelled sample row, free.

💰 How much does it cost to scrape Social Blade?

$1.00 per 1,000 profiles on the Free plan. Paid plans pay a little less: $0.99 on Starter, $0.98 on Scale and $0.97 on Business. On the free plan, the $5 Apify gives you each month covers about 5,000 profiles.

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 you give it

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

Field	Default	What it is
profiles	none	Social Blade URLs, or platform:identifier. A bare handle uses the platform set below. The form opens with three examples.
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.
resultsPerQuery	5	Matches to keep per search query, up to 20.
includeGrowth	true	The 3 to 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. Off gives a faster run without the grade and rank block.
proxyConfiguration	off	Optional. Only your own server URLs are used here.

Use GB for Britain on a leaderboard. UK returns an empty list with no warning, and a country code Social Blade does not know comes back as a BAD_REQUEST row.

📤 What you get back

A real row from a real 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	How to read it
grade	Social Blade's letter grade, from A++ down.
ranks	The overall rank plus the per-metric, country and category ranks where the platform has them.
resolvedVia	direct, search-exact, search-best, search, top-list or top-list-lite.
socials	YouTube only, and on under a third of rows.

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.

About the earnings figures

estimatedMonthlyEarningsUsd and estimatedYearlyEarningsUsd are Social Blade's own estimates, not reported revenue. 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 so. Treat them as a rough bracket.

🧾 Reading the output

Row	How to spot it	Billed
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

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.
BAD_REQUEST, API_ERROR, ERROR	Social Blade answered badly, or did not accept a value. Check the entry and run it again.
NOT_SERVED	This profile was not served this run. Re-run it later. Until 12 October 2026 this code was called BLOCKED.
TIME_LIMIT	The run got close to its time limit and stopped on its own. The profiles delivered before that are complete and charged. Give the run more time, or ask for fewer profiles, to get the rest.

A diagnostic never fails the run, except one: when the time limit stopped the run before any profile came back, the run ends as failed, with a TIME_LIMIT row saying so.

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.

💡 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.
• Screening an influencer list: grade, rank and a year of growth in one row each.

From a country's top 100 to what the fastest risers upload, in three steps:

1. Run this actor with topLists set to youtube/subscribers/IN (or your country).
2. Sort the rows by the 30-day subscriber growth in growth and copy the top id values.
3. Put those channel ids into YouTube Channel Scraper as channelUrls to read their latest uploads.

🚧 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 lookups 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.
• It is not an official Social Blade tool. Dami's Studio is independent and is not affiliated with or endorsed by Social Blade, or by any other company named on this page.

🧭 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 uploads as rows	YouTube Channel Scraper
A TikTok account's live followers, likes and bio	TikTok Profile Scraper
Instagram profiles with exact follower counts and bio links	Instagram Profile Scraper
A creator's accounts on other networks, from a name or a website	Social Profile Finder

❓ Questions people ask

Do I need a Social Blade account or API key?

No. Everything here is public on Social Blade.

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 Social Blade earnings estimates accurate?

No. See the earnings note above.

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.

Can I call it from code or connect it to an AI assistant?

Yes. The API tab has ready-made code for Python, JavaScript and the command line. For Claude, ChatGPT or another MCP client, connect https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/socialblade-scraper. Either way the run happens on your Apify account at the same price.

Is scraping Social Blade legal?

These are public creator statistics on a public site. Apify's write-up on the legality of web scraping 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.