# Social Blade Scraper (`parseforge/socialblade-scraper`) Actor

Scrapes Social Blade top lists and profile pages for YouTube, TikTok, Instagram, Twitch, and Facebook. Returns creator rank, username, subscriber or follower count, video or view totals, and country as flat rows.

- **URL**: https://apify.com/parseforge/socialblade-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Social media, Developer tools, Other
- **Stats:** 39 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.19 / 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/actors/running/actors-in-store.md#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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Social Blade Scraper

**Scrape Social Blade creator rankings, stats, and top lists for YouTube, TikTok, Instagram, Twitch, and Facebook.** Get subscriber counts, view totals, uploads, and country rankings in one flat dataset. No login or API key. Export to CSV, JSON, Excel, or XML.

Social Blade's public rankings are the fastest way to see which creators are growing, but the site has no official API and manual copying is slow. This Actor reads the top lists and profile pages directly, filtered by platform, sort order, and country, and returns each creator as one clean row.

| Who uses it | What they scrape Social Blade for |
|---|---|
| Influencer marketing agencies | Build a shortlist of fast-growing creators in a target country for outreach |
| Market researchers | Track which YouTube or TikTok channels are gaining subscribers week over week |
| Content strategists | Find top-performing creators in a niche to model content and posting cadence |
| Data journalists | Pull public ranking data to report on platform trends and creator economies |
| Competitive intelligence teams | Monitor subscriber and view counts for a set of competitor channels |

### What it does

This Actor collects Social Blade creator profiles from top lists or direct URLs and returns each one as a flat row with rank, platform, username, subscriber or follower count, video or view totals, and country.

- 🌍 **Platform top lists:** scrape the most subscribed, most viewed, or most followed creators on YouTube, TikTok, Instagram, Twitch, or Facebook.
- 🔗 **Direct URL mode:** paste any Social Blade profile or top list URL and get exactly that page as structured data.
- 🌐 **Country filter:** narrow the top list to a single country code like US, GB, or IN, or leave empty for worldwide.
- 📊 **Flat row output:** every creator comes back as one row with rank, username, counts, and country, ready for CSV or Excel.
- ⚡ **Up to 1,000,000 profiles:** paid users can pull the full top list in one run; free users are limited to 100.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Social Blade data

**📈 Track creator growth.**

A market researcher runs the Actor weekly on the YouTube most subscribed list for the US and compares subscriber counts to spot breakout channels.

**🎯 Build influencer shortlists.**

An agency filters TikTok's most followed list by country and exports the top 200 creators to start outreach for a campaign.

**📰 Report on platform trends.**

A data journalist scrapes Twitch's most viewed list and combines it with other data to write about which streamers dominate.

**🔍 Monitor competitors.**

A content strategist pastes direct URLs for 50 competitor YouTube channels and gets their current subscriber and view counts in one run.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key** | Social Blade has no public API, so this reads the pages you would open in a browser |
| **One fixed schema** | Every creator, regardless of platform, comes back with the same field names |
| **Country-level data** | Filter top lists by country code to see regional rankings, not global |
| **Bulk export** | Save results as CSV, JSON, Excel, or XML for analysis in any tool |

### How it compares

This Actor is the only one in this set that scrapes Social Blade creator rankings and stats; the competitor below focuses on extracting contact details from bio link pages, which is a different job.

| Feature | ParseForge | Linktree, Beacons & Bio Email Scraper: Extract Leads |
|---|---|---|
| Scrapes Social Blade top lists | Yes | Not listed |
| Returns creator subscriber or follower counts | Yes | Not listed |
| Filters by platform and country | Yes | Not listed |
| Extracts email addresses from profiles | Not listed | Yes |
| Handles direct profile URLs | Yes | Yes |

### Configure the run

Drive the Actor from a direct Social Blade URL or from platform, sort order, and country filters, and set a maximum number of profiles to return. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "maxItems": 10,
 "platform": "youtube",
 "sortBy": "mostsubscribed"
}
```

A larger pull:

```json
{
 "maxItems": 200,
 "platform": "youtube",
 "sortBy": "mostsubscribed"
}
```

### Pricing

Pay-per-result: **$0.0117 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $1.17 |
| 1,000 results | $11.70 |
| 10,000 results | $117.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Social Blade Scraper](https://apify.com/parseforge/socialblade-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Social Blade through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/socialblade-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your filters match a real top list. For example, mostfollowed is valid for Instagram and TikTok but not for YouTube. Also try a direct URL to confirm the page loads.

**Why did the run stop at 100 profiles?**

Free Apify users are limited to 100 items per run. Upgrade to a paid plan to increase maxItems up to 1,000,000.

**Why is the country filter not working?**

Use the two-letter country code, like US or GB, without spaces. If the country is not available for that platform, the worldwide list is returned.

**Why does a direct URL return only one row?**

A direct profile URL returns that single creator. To get a list, use a top list URL or the platform and sortBy filters.

**Why are some fields empty?**

Social Blade sometimes hides certain stats for smaller creators or on certain platforms. The Actor returns what is publicly visible.

### FAQ

| Question | Answer |
|---|---|
| Do I need a Social Blade account or API key? | No. The Actor reads the public pages directly, so no login or key is required. |
| Which platforms can I scrape? | YouTube, TikTok, Instagram, Twitch, and Facebook top lists are supported, plus any direct Social Blade profile URL. |
| Can I filter by country? | Yes. Set the country field to a two-letter code like US, GB, or IN. Leave it empty for worldwide rankings. |
| What is the maximum number of profiles I can get? | Free users are limited to 100 profiles per run. Paid users can set maxItems up to 1,000,000. |
| What does the output look like? | Each creator is one flat row with fields like rank, platform, username, subscriber or follower count, video or view totals, and country. |
| Can I scrape a single profile instead of a top list? | Yes. Paste the profile URL into startUrl and the Actor returns that one creator as a row. |
| Does this work for Instagram and Facebook? | Yes, the platform filter includes Instagram and Facebook, and direct URLs for those profiles work too. |
| How often should I run this? | Daily or weekly runs are common for tracking growth. You can schedule the Actor in Apify to run automatically. |
| Is the data live? | The Actor reads Social Blade at the moment of the run, so you get the counts shown on the site at that time. |
| Can I export to Excel? | Yes, results can be exported as CSV, JSON, Excel, or XML from the Apify dataset. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Social Blade LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `startUrl` (type: `string`):

Direct Social Blade URL to scrape (e.g. https://www.socialblade.com/youtube/top/50/mostsubscribed). If provided, platform/sortBy filters are ignored.

## `maxItems` (type: `integer`):

Free users: Limited to 100. Paid users: Optional, max 1,000,000.

## `platform` (type: `string`):

Social media platform to scrape top lists from.

## `sortBy` (type: `string`):

How to sort the top list.

## `country` (type: `string`):

Filter by country code (e.g. US, GB, IN). Leave empty for worldwide.

## Actor input object example

```json
{
  "maxItems": 10,
  "platform": "youtube",
  "sortBy": "mostsubscribed"
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with all scraped items

# 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 = {
    "maxItems": 10,
    "platform": "youtube",
    "sortBy": "mostsubscribed"
};

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

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "platform": "youtube",
    "sortBy": "mostsubscribed",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/socialblade-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 '{
  "maxItems": 10,
  "platform": "youtube",
  "sortBy": "mostsubscribed"
}' |
apify call parseforge/socialblade-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/socialblade-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 <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/oPAudTtiGcu0jGQB2/builds/Fhe52DnrFojXMAOTO/openapi.json