# Social Blade Scraper (Cheap) (`data_api/social-blade-scraper-cheap`) Actor

Extract Social Blade channel stats, including grades, subscriber counts, monthly growth, and estimated earnings for YouTube, TikTok, Twitch, Instagram, and Facebook creators. Supports single profiles and bulk ranking list scrapes.

- **URL**: https://apify.com/data\_api/social-blade-scraper-cheap.md
- **Developed by:** [Data API](https://apify.com/data_api) (community)
- **Categories:** Social media, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Social Blade Stats Scraper

![Social Blade Stats Scraper](cover.jpg)

Social Blade tracks the numbers behind nearly every creator, but the site gives you one profile at a time and nothing you can drop into a spreadsheet. This scraper fixes that. Hand it a handle, a batch of handles, or a ranking-page URL and it returns subscriber counts, letter grades, 30-day growth, earnings estimates, and ranks as clean rows. It works across YouTube, TikTok, Twitch, Instagram, and Facebook, so you can pull a whole shortlist in a single run.

### What you get

Each profile or ranking entry comes back as one row with a steady set of columns, so results line up neatly in a sheet or database. Missing values arrive as `null` rather than disappearing. The data falls into a few groups:

- **Identity** — `handle`, `channelName`, `profileId`, `networkName`, `profileLink`, `countryCode`, `contentNiche`, `joinedDate`, `bio`
- **Reach** — `audienceSize`, `lifetimeViews`, `contentCount`
- **Rankings and grade** — `sbGrade`, `overallRank`, `audienceRank`, `viewRank`, `countryPlacement`, `nicheRank`, `listPosition`
- **Growth and money** — `audienceGrowth30d`, `viewGrowth30d`, `earningsEstimate`
- **Run metadata** — `rankingPageUrl`, `collectedAt`, `errorMessage`

### Quick start

1. Click **Try for free** to open the input form.
2. For a single creator, type a handle into **Creator handle** and choose a **Network**. For several, paste them into **Creator handles (bulk)**, one per line.
3. To grab a whole ranking instead, paste a Social Blade top or worst page into **Ranking page URL** — that overrides the profile fields.
4. Set a **Results cap** if you want to keep the run small.
5. Press **Start**, then export as JSON, CSV, Excel, or XML once it finishes.

![How it works](how-it-works.jpg)

### Use cases

- **Influencer outreach** — rank candidates by grade, audience size, and recent growth before you reach out
- **Agency reporting** — pull a weekly snapshot for every channel you manage in one scheduled run
- **Sponsorship vetting** — confirm a creator's real reach and grade before signing
- **Niche trend research** — scrape top lists to see which categories are climbing
- **Creator economy study** — gather earnings bands and growth figures across verticals
- **Competitive benchmarking** — line up rival channels side by side on the same metrics

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `channelHandle` | string | One of `channelHandle`, `channelHandles`, or `rankingUrl` | A single Social Blade handle, e.g. `MrBeast`. Prefill example: `MrBeast`. |
| `channelHandles` | array of strings | Optional | Several handles to fetch at once, one per line. |
| `networkName` | string | No | Network to query: youtube, tiktok, twitch, facebook, or instagram. Default `youtube`. |
| `rankingUrl` | string | Optional | A Social Blade top or worst ranking page (must contain `socialblade.com`). When set, the profile fields are skipped. |
| `resultsLimit` | integer | No | Cap on profiles or ranking rows per run, up to 1000. Default `50`. |
| `timeoutSeconds` | integer | No | Seconds to wait on each request before giving up. Default `45`. |

#### Example input

```json
{
    "channelHandles": ["MrBeast", "veritasium", "mkbhd"],
    "networkName": "youtube",
    "resultsLimit": 50,
    "timeoutSeconds": 45
}
```

For a ranking page instead:

```json
{
    "rankingUrl": "https://socialblade.com/youtube/lists/top/100/subscribers/all/global",
    "resultsLimit": 100
}
```

### Output

Every handle or ranking entry becomes a single row. Profile runs fill in the growth and earnings fields; ranking runs fill in `listPosition` and `rankingPageUrl`. Fields that don't apply to a given mode come back as `null`.

#### Example output

```json
{
    "listPosition": null,
    "handle": "MrBeast",
    "channelName": "MrBeast",
    "profileId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "networkName": "youtube",
    "profileLink": "https://socialblade.com/youtube/user/MrBeast",
    "sbGrade": "A++",
    "overallRank": 3,
    "audienceRank": 1,
    "viewRank": 2,
    "countryPlacement": 1,
    "nicheRank": 1,
    "audienceSize": 340000000,
    "lifetimeViews": 85000000000,
    "contentCount": 820,
    "countryCode": "US",
    "contentNiche": "Entertainment",
    "joinedDate": "2012-02-19",
    "bio": "SUBSCRIBE FOR A COOKIE",
    "audienceGrowth30d": 8500000,
    "viewGrowth30d": 2100000000,
    "earningsEstimate": "$145K - $362K",
    "rankingPageUrl": null,
    "collectedAt": "2026-06-29T08:42:11.000000+00:00",
    "errorMessage": null
}
```

#### Output fields

| Field | Type | Description |
|-------|------|-------------|
| `listPosition` | integer | Position in the ranking (ranking mode only) |
| `handle` | string | The Social Blade handle that was queried |
| `channelName` | string | Public name of the channel or account |
| `profileId` | string | Social Blade's internal profile ID |
| `networkName` | string | Network the profile belongs to |
| `profileLink` | string | Social Blade page that was read |
| `sbGrade` | string | Letter grade from A++ down to F |
| `overallRank` | integer | Rank across every channel on the network |
| `audienceRank` | integer | Rank by subscriber or follower count |
| `viewRank` | integer | Rank by total views |
| `countryPlacement` | integer | Rank inside the profile's country |
| `nicheRank` | integer | Rank within the content category |
| `audienceSize` | integer | Subscriber or follower total |
| `lifetimeViews` | integer | All-time view count |
| `contentCount` | integer | Uploads, posts, or clips published |
| `countryCode` | string | Country tied to the profile |
| `contentNiche` | string | Category or channel type |
| `joinedDate` | string | Account creation date (YYYY-MM-DD) |
| `bio` | string | Channel or account description (profile mode only) |
| `audienceGrowth30d` | integer | Net follower change over 30 days (profile mode only) |
| `viewGrowth30d` | integer | Net view change over 30 days (profile mode only) |
| `earningsEstimate` | string | Monthly earnings band (YouTube profile mode only) |
| `rankingPageUrl` | string | The ranking page that produced this row (ranking mode only) |
| `collectedAt` | string | ISO-8601 UTC capture timestamp |
| `errorMessage` | string | Reason a profile failed; `null` on success |

### Tips for best results

- **Test with a couple of handles first.** Run two or three before a big batch so you can confirm the columns fit your pipeline.
- **Keep test runs cheap with `resultsLimit`.** Set it to 10–20 while you check the output, then raise it for the full job.
- **Raise `timeoutSeconds` if you see timeouts.** The default of 45 suits most pages; push it toward 90 on slower runs.
- **Pick the right `networkName`.** A handle that exists on TikTok may not exist on YouTube, so match the network to the creator.
- **A failed profile won't stop the run.** If a handle is private or missing, that row carries an `errorMessage` and the rest keep going.
- **Schedule repeat runs for trends.** Run daily or weekly from the Apify console and compare `audienceGrowth30d` over time.

### How can I use Social Blade creator data?

**How can I use the Social Blade Stats Scraper to vet influencers before a campaign?**
Drop a list of handles into `channelHandles`, pick the `networkName`, and the scraper returns each creator's `audienceSize`, `sbGrade`, and `audienceGrowth30d` in one run. Sort by grade and recent growth to separate real momentum from inflated follower counts before you spend on outreach.

**How can I pull a Social Blade top list into a spreadsheet?**
Paste a ranking page into `rankingUrl`, such as a top-100 followers list, and the scraper walks the whole page. Every creator comes back with a `listPosition`, `audienceSize`, and `profileLink`. Export to CSV or Excel and you have a ready-made leaderboard without copying rows by hand.

**How can I track creator growth over time with Social Blade data?**
Schedule the actor to run on the same handles daily or weekly. Each run records `audienceGrowth30d`, `viewGrowth30d`, and a `collectedAt` timestamp, so stacking the datasets gives you a clean growth history for trend charts or reporting.

**How can I compare creators across YouTube, TikTok, and Instagram?**
Run the scraper once per network with the matching handles, then join the results on `handle`. Every row shares the same fields, including `audienceSize`, `sbGrade`, and `contentCount`, so you can benchmark the same creator's reach across platforms in a single view.

### Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

### Support

Questions, feature requests, or a field you'd like added? Reach out at <data.apify@proton.me> and we'll get back to you.

# Actor input Schema

## `channelHandle` (type: `string`):

One Social Blade handle or channel name to fetch stats for, such as MrBeast, pokimane, or selenagomez.

## `channelHandles` (type: `array`):

Several handles to fetch in one go, one per line. Combine with the single handle field if you like.

## `networkName` (type: `string`):

Which social network to query on Social Blade.

## `rankingUrl` (type: `string`):

A Social Blade top or worst ranking page (the address must include 'socialblade.com'). Set this and the single-profile fields above are skipped.

## `resultsLimit` (type: `integer`):

Ceiling on how many profiles or ranking rows a single run returns. Handy for keeping test runs small.

## `timeoutSeconds` (type: `integer`):

How long to wait on each page before giving up. Bump it higher if you hit timeout errors.

## Actor input object example

```json
{
  "channelHandle": "MrBeast",
  "channelHandles": [
    "MrBeast",
    "veritasium",
    "mkbhd"
  ],
  "networkName": "youtube",
  "rankingUrl": "https://socialblade.com/youtube/lists/top/100/subscribers/all/global",
  "resultsLimit": 50,
  "timeoutSeconds": 45
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "channelHandle": "mrbeast",
    "networkName": "youtube",
    "rankingUrl": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("data_api/social-blade-scraper-cheap").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "channelHandle": "mrbeast",
    "networkName": "youtube",
    "rankingUrl": "",
}

# Run the Actor and wait for it to finish
run = client.actor("data_api/social-blade-scraper-cheap").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 '{
  "channelHandle": "mrbeast",
  "networkName": "youtube",
  "rankingUrl": ""
}' |
apify call data_api/social-blade-scraper-cheap --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,data_api/social-blade-scraper-cheap"
        }
    }
}

```

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 <APIFY_API_TOKEN>` 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/f3LzHLIEi4YToOqWd/builds/5Hz7rg6qItxnKa1BZ/openapi.json