## SocialBlade Stats Scraper
**💰 $1.02 / 1 000 results** · pay only for results · no credit card to try
*We do the dirty work so your dataset stays clean.* 😈
Scrape SocialBlade creator/channel stats across YouTube, Twitch, Instagram, and TikTok — subscriber/follower counts, view counts, SocialBlade's letter grade, platform + category ranks, and 15-day daily growth history, normalized per handle.
{"platform":… |
| `includeHistory` | `boolean` | no | True | Include the 15-day daily growth history array in each row. |
| `maxItems` | `integer` | no | 100 | Cap on number of targets processed in one run. |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': True, 'apifyProxyGroups': \['RESIDENTIAL']} | Apify Proxy config; residential group recommended at scale. |
#### Example input
```json
{
"targets": [
{
"platform": "youtube",
"handle": "mrbeast6000"
},
{
"platform": "twitch",
"handle": "pokimane"
},
{
"platform": "instagram",
"handle": "cristiano"
},
{
"platform": "tiktok",
"handle": "khaby.lame"
}
],
"includeHistory": true,
"maxItems": 4,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
### 📤 Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `platform` | `string` | Platform this row was scraped from: youtube, twitch, instagram, or tiktok. |
| `handle` | `string` | Username/handle as supplied or resolved. |
| `channel_id` | `['string', 'null']` | SocialBlade's internal channel/user id. |
| `display_name` | `['string', 'null']` | Display name, where SocialBlade exposes it. |
| `avatar_url` | `['string', 'null']` | Profile avatar image URL. |
| `follower_count` | `integer` | Normalized subscriber/follower count. |
| `view_count` | `['integer', 'null']` | Total view count (YouTube only). |
| `content_count` | `['integer', 'null']` | Video/media/post count; null for Twitch (no such field). |
| `grade` | `string` | SocialBlade's own composite letter grade for the channel, e.g. 'A++' — not our assessment. |
| `country` | `['string', 'null']` | Creator's country, where exposed. |
| `ranks` | `['object', 'null']` | SocialBlade rank breakdown: sb, primary, views, country, category. |
| `engagement_rate` | `['number', 'null']` | Instagram-only average engagement rate. |
| `avg_likes` | `['number', 'null']` | Instagram-only average likes per post. |
| `avg_comments` | `['number', 'null']` | Instagram-only average comments per post. |
| `total_likes` | `['integer', 'null']` | TikTok-only lifetime total likes (not per-post). |
| `verified` | `['boolean', 'null']` | TikTok-only verified-badge flag. |
| `growth_history` | `array` | Up to 15 daily snapshots; empty when include\_history=false or unavailable on SocialBlade's side. |
| `source_url` | `string` | Resolved SocialBlade profile URL that was fetched. |
| `scraped_at` | `string` | ISO-8601 UTC timestamp this row was written. |
#### Example output
```json
{
"platform": "youtube",
"handle": "MrBeast",
"channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"display_name": "MrBeast",
"avatar_url": "https://.../avatar.jpg",
"follower_count": 512000000,
"view_count": 136403988890,
"content_count": 996,
"grade": "A++",
"country": "US",
"ranks": {
"sb": 7,
"primary": 1,
"views": 6,
"country": 1,
"category": 1
},
"growth_history": [
{
"date": "2026-08-09T00:00:00Z",
"follower_count": 511998200,
"view_count": 136403001234,
"content_count": 996
}
],
"source_url": "https://socialblade.com/youtube/user/mrbeast6000",
"scraped_at": "2026-08-10T12:00:00Z"
}
```
### 💰 Pricing
Pay-Per-Event — you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.02 | One-off warm-up charge per run |
| `result-emitted` | $0.001 | Per unique dataset item |
Example: 1 000 results at the rates above ≈ **$1.02**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.
### 🚧 Limitations
v1 covers YouTube, Twitch, Instagram, and TikTok only — other platforms SocialBlade tracks are out of scope. Estimated Monthly/Yearly Earnings are not scraped — that figure loads client-side after hydration and isn't present in the data we parse. Growth history is capped at SocialBlade's own 15-day window — no backfill beyond that.
### ❓ FAQ
**Do I need a SocialBlade account or API key?**
No. This Actor reads SocialBlade's own publicly listed profile data — no login, no API key.
**Does this include SocialBlade's Estimated Monthly/Yearly Earnings figures?**
No. Those numbers load client-side after the page hydrates and aren't present in the data we parse — v1 doesn't fabricate or estimate them. This Actor's edge is broader multi-platform coverage plus growth history in one pass, not an earnings guess.
**Why is `growth_history` sometimes an empty array?**
Some accounts (confirmed on Instagram) don't have a populated history query on SocialBlade's side. The row still emits with `growth_history: []` instead of failing.
**Can I mix platforms in one run?**
Yes — `targets` accepts any mix of platform/handle pairs (or direct URLs) across all four supported platforms in a single run.
**Is the letter grade our assessment?**
No — `grade` is SocialBlade's own composite score (e.g. `A++`, `D`), passed through as-is. We don't compute or adjust it.
### 💬 Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema
## `targets` (type: `array`):
Channels/creators to scrape, one row per target. Each item is either {"platform": "youtube|twitch|instagram|tiktok", "handle": "..."} or a direct {"url": "https://socialblade.com/\/user/\"} — url takes precedence when both are given. At least 1 target is required.
## `includeHistory` (type: `boolean`):
Include the 15-day daily growth history array in each row.
## `maxItems` (type: `integer`):
Cap on number of targets processed in one run.
## `proxyConfiguration` (type: `object`):
Apify Proxy config; residential group recommended at scale.
## Actor input object example
```json
{
"targets": [
{
"platform": "youtube",
"handle": "mrbeast6000"
}
],
"includeHistory": true,
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"targets": [
{
"platform": "youtube",
"handle": "mrbeast6000"
}
],
"includeHistory": true,
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/socialblade-stats-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"targets": [{
"platform": "youtube",
"handle": "mrbeast6000",
}],
"includeHistory": True,
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/socialblade-stats-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"targets": [
{
"platform": "youtube",
"handle": "mrbeast6000"
}
],
"includeHistory": true,
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call devilscrapes/socialblade-stats-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,devilscrapes/socialblade-stats-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/zppcUpRrmNNp1JQnS/builds/hD3uXcoXeZ4tndiUK/openapi.json