# Social Blade Scraper - Creator Stats, Ranks, History & Earnings (`topapi/socialblade-scraper`) Actor

Scrape Social Blade stats for YouTube, TikTok, Instagram, Twitch and Facebook creators: grade, ranks, subscribers, views, 15-day daily history, estimated earnings, projections, milestones and top lists. No login or API key. From $1.60 per 1,000 creators, no start fee.

- **URL**: https://apify.com/topapi/socialblade-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Social media, Videos
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 creator rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Social Blade Scraper do?

**Social Blade Scraper** reads [socialblade.com](https://socialblade.com) creator statistics for **YouTube, TikTok, Instagram, Twitch and Facebook** and returns one clean row per creator: Social Blade grade, every rank, subscribers / followers / views / uploads / likes, the last 15 days of daily history with daily gains, growth over 1, 3, 7 and 14 days, YouTube estimated earnings, projections, YouTube milestones and Social Blade's top 100 rankings. Give it creator links, handles, YouTube channel ids, search terms or a ranking. Also known as a Social Blade API, SocialBlade scraper or YouTube / TikTok stats scraper.

- 📊 **Every Social Blade profile field** - grade, SB rank, subscriber / follower rank, views rank, country and category rank, Instagram engagement rate, Facebook "talking about", verified badges, channel country, category and creation date.
- 📅 **Daily history included in the price** - the 15-day table Social Blade shows without an account, with each day's gains (no extra "history" event).
- 💰 **YouTube estimated earnings** - Social Blade's own formula (views gained / 1,000 x $0.25-$4 CPM): per day, week, month, quarter, half year and year, with your own CPM range and currency if you want.
- 🔮 **Projections and next milestone** - audience, views and uploads in 30 days to 5 years, and the date of the next round audience number.
- 🏆 **Rankings** - top 100 lists by subscribers, views or videos for 16 YouTube categories and 246 countries, TikTok, Instagram, Twitch and Facebook top lists, and growth / decline lists.
- 🔁 **Monitor mode** - on a daily schedule, deliver only creators with a new Social Blade day, with the change since your last run.
- 🔓 **No login, no API key, no browser** - reads the pages Social Blade serves to every visitor.

### What data can you get from Social Blade?

| | | |
|---|---|---|
| 🅰️ Grade `sb_grade` | 🏅 SB rank `sb_rank` + every rank in `ranks` | 👥 Subscribers / followers `audience` |
| 👁️ Views `views` | 🎬 Uploads `videos` | ❤️ Likes `likes` (TikTok, Facebook) |
| 📈 Daily table `daily_growth` | ➕ Gains `subscribers_last_7d`, `views_last_14d`… | 📉 Average gain `audience_gain_per_day` |
| 💵 Earnings `estimated_earnings` | 💵 Per day `estimated_earnings_daily` | 🔮 Projections `projections` |
| 🎯 Next milestone `next_milestone` | 🏁 Milestones `milestones` (YouTube add-on) | 🌍 Country / category |
| 📣 Engagement rate (Instagram) | 🗣️ Talking about (Facebook) | ✅ Verified / made for kids |
| 🖼️ Avatar, banner, description | 🔗 Socials, website, identifiers | 🏆 Ranking position `rank` |

### How to scrape Social Blade with Social Blade Scraper

1. [Sign up for a free Apify account](https://console.apify.com/sign-up) (it comes with free monthly credit).
2. Open **Social Blade Scraper** and click **Try for free**.
3. Paste creators into **Creators** (links, `platform:handle`, @handles or YouTube channel ids), or add **Search terms**, or pick a **Ranking**.
4. Click **Start**.
5. When the run finishes, download the rows as JSON, CSV or Excel, or read them through the Apify API.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `profiles` | list | Creators: `https://socialblade.com/youtube/handle/mrbeast`, `https://www.youtube.com/@veritasium`, `https://www.youtube.com/channel/UC…`, `https://www.tiktok.com/@khaby.lame`, `https://www.instagram.com/nasa`, `https://www.twitch.tv/kaicenat`, `https://www.facebook.com/nasa`, `tiktok:khaby.lame`, `@mrbeast`, `UCX6OQ3DkcsbYNE6H8uQQuVA`. Prefilled with 3 creators. |
| `platform` | select | Platform of bare handles and search terms: YouTube (default), TikTok, Instagram, Twitch, Facebook, or **All platforms** (looks a handle up on all five). |
| `searchQueries` | list | Names to look up with Social Blade's own search; each match becomes a full creator row. |
| `resultsPerQuery` | integer | Creators taken per search term (default 5; Social Blade returns up to 25 on YouTube, 5 elsewhere). |
| **🏆 Rankings** | | |
| `rankingPlatform` | select | Pull a Social Blade ranking (default: none). |
| `rankingType` | select | Top (biggest), Growth (most gained) or Decline (most lost). |
| `rankingMetric` | select | YouTube: subscribers, views, videos · TikTok: followers, likes · Instagram: followers, posts · Twitch: followers · Facebook: likes, talking about. |
| `rankingCategory` / `rankingCountry` | select / text | YouTube top lists: one of 16 categories and a two-letter country or `global`. |
| `rankingPeriod` | select | Growth / decline lists: last day or last 3 days. |
| `rankingLimit` | integer | Rows of the ranking (1-100, default 100). |
| `rankingMadeForKids` | select | YouTube top lists: show all, hide or only made-for-kids channels. |
| `listUrls` | list | Social Blade ranking links read as they are. |
| `enrichRankings` | boolean | Open every ranked creator's page for the full profile (default off). |
| **📈 History & estimates** | | |
| `includeHistory` | boolean | The daily table (default on). |
| `historyDays` / `historySince` | integer / date | Keep the last N days (1-15) or the days on or after a date. |
| `includeEarnings` | boolean | YouTube earnings estimates (default on). |
| `earningsCurrency`, `cpmMinUsd`, `cpmMaxUsd` | text / number | Currency (converted with Social Blade's own exchange rates) and CPM range (default $0.25-$4). |
| `includeProjections` | boolean | Projections and next milestone (default on). |
| **➕ Extra data** | | |
| `includeMilestones` | boolean | YouTube milestones: the date each subscriber, view and upload milestone was reached ($0.0008 per channel, charged only when delivered). |
| **✂️ Refine results** | | |
| `minAudience` / `maxAudience` | integer | Audience range (subscribers, followers or page likes). |
| `minGrade` | select | Keep creators graded at least A++ … C-. |
| `countries` / `categories` | list | YouTube country codes and categories to keep. |
| `verifiedOnly`, `madeForKids` | boolean / select | Verified creators only; keep, drop or only made-for-kids channels. |
| **🔁 Monitoring** | | |
| `monitorMode`, `monitorOutput`, `monitorStoreName` | | Deliver only new or updated creators since the last run of the same store name. |
| **📦 Output** | | |
| `maxItems` | integer | Most rows to deliver (default 100; 0 = no limit). |
| `compact` | boolean | Core columns only, for AI agents and spreadsheets. |
| **⚙️ Advanced** | | |
| `proxyConfiguration`, `maxConcurrency` | | Optional proxy to try first; pages read at once (default 4). |

#### Input JSON

```json
{
  "profiles": ["https://socialblade.com/youtube/handle/mrbeast", "tiktok:khaby.lame", "twitch:kaicenat"],
  "searchQueries": ["veritasium"],
  "rankingPlatform": "youtube",
  "rankingCategory": "games",
  "rankingCountry": "US",
  "rankingLimit": 50,
  "includeMilestones": true,
  "maxItems": 100
}
```

#### Give the platform when a handle is ambiguous

`khaby.lame` alone is read as a YouTube handle (the default platform). Write `tiktok:khaby.lame`, paste the TikTok link, or set **Platform for bare handles** to TikTok. Set it to **All platforms** to look a name up on all five.

#### YouTube channel ids and old links work too

`UC…` channel ids, `/channel/`, `/user/` and `/c/` links are resolved to the channel's handle through Social Blade's own search, then read. X / Twitter, Dailymotion and Kick links are skipped with a reason: Social Blade no longer has pages for them.

#### Rankings are first pages of 100

Social Blade serves top lists of 10, 50 or 100 rows to visitors without an account, and growth / decline lists over the last 1 or 3 days. Turn on **Full profile for every ranked creator** when you need grade, ranks and history for each ranked channel.

### ⬆️ Output

One row per creator. `type` is `profile` (a creator page) or `ranking` (a ranking row without the full profile). Real row from a run on 2026-10-28 (YouTube comedy top list, full profiles on; arrays shortened):

```json
{
  "type": "profile",
  "platform": "youtube",
  "creator_id": "UC6QZ_ss3i_8qLV_RczPZBkw",
  "creator_handle": "issei0806",
  "display_name": "ISSEI / いっせい",
  "url": "https://socialblade.com/youtube/handle/issei0806",
  "rank": 1,
  "sb_grade": "B+",
  "subscribers": 75600000,
  "views": 61976688799,
  "videos": 4502,
  "sb_rank": 7059,
  "country_rank": 2,
  "category_rank": 1,
  "country": "JP",
  "category": "comedy",
  "sb_data_date": "2026-10-28",
  "views_last_14d": 49838362,
  "estimated_earnings": { "monthly": { "min": 26699.12, "max": 427185.96, "currency": "USD", "formatted": "$26.7K - $427.2K" } },
  "daily_growth": [{ "date": "2026-10-28", "subscribers": 75600000, "views": 61976688799, "videos": 4502, "views_gained": 795260, "estimated_earnings_min": 198.82, "estimated_earnings_max": 3181.04 }],
  "projections": [{ "days": 365, "date": "2027-10-28", "subscribers": 72992857, "views": 63276046094, "videos": 4580 }]
}
```

An Instagram row carries `followers`, `following`, `media_count`, `engagement_rate` (1.08 for cristiano), `average_likes`, `average_comments` and its ranks; a Facebook row `likes` and `talking_about`; a TikTok row `followers`, `following`, `likes`, `videos`; a Twitch row `followers`. A column a platform does not have is left off its rows.

#### Fields

Fill measured on 995 YouTube profiles (run Rqe6FS2qSRKdQVexb, 2026-10-28) and 1,000 ranking rows from 10 rankings (run NmACceqBBedQ26TzS).

| Field | Meaning | Fill |
|---|---|---|
| `creator_id`, `creator_handle`, `display_name`, `url`, `platform_url` | Who and where | 100% |
| `sb_grade` | Social Blade grade | 100% of profiles (rankings carry none) |
| `subscribers`, `views`, `videos` | YouTube totals | 100% |
| `ranks`, `sb_rank`, `audience_rank`, `category_rank` | Social Blade ranks | 100% |
| `views_rank` / `country_rank` | | 99% / 89% |
| `country` / `category` / `made_for_kids` / `created_at` | Channel facts | 89% / 100% / 100% / 100% |
| `description` / `banner` / `socials` | | 96% / 99% / 4% |
| `daily_growth`, `history_days` (15 on every row) | Daily table | 100% |
| `subscribers_last_1d` … `_14d`, `views_last_*`, `videos_last_*` | Growth windows | 100% |
| `estimated_earnings`, `estimated_earnings_daily`, `estimated_monthly_earnings_min/max`, `estimated_yearly_earnings_min/max` | YouTube earnings | 100% |
| `projections`, `next_milestone` | Projections | 100% |
| `milestones`, `first_tracked` | YouTube add-on | 49 of 50 rows asked (the 50th channel has no handle on Social Blade) |
| `rank`, `ranking`, `period_gains` | Ranking rows | 100% (`period_gains` on growth / decline lists) |
| `change_type`, `previous_audience`, `audience_change_since_last_run` | Monitor mode | every monitored row |

### Use cases

- 🤝 **Influencer agencies** - vet creators by grade, audience, 14-day growth and estimated earnings before an offer.
- 📣 **Brand and sponsorship teams** - shortlist channels from a category / country top 100 and check their daily trend.
- 📈 **Talent managers and MCNs** - schedule a daily run of your roster and get only the creators with new numbers.
- 🧪 **Analysts and researchers** - build a time series of Social Blade stats across YouTube, TikTok, Instagram, Twitch and Facebook.
- 🤖 **AI agents** - compact rows with the headline numbers, through the Apify API or MCP.

### How much does it cost to scrape Social Blade?

Pay per result, no start fee:

| Event | Price |
|---|---|
| Creator row (profile or ranking row; history, growth, earnings and projections included) | **$0.0016** ($1.60 per 1,000) |
| YouTube milestones add-on (only when delivered) | $0.0008 |

| Run | Rows | Price |
|---|---|---|
| 10 creators | 10 | $0.016 |
| 100 creators | 100 | $0.16 |
| 100 YouTube creators with milestones | 100 + 100 | $0.24 |
| 1,000 ranking rows | 1,000 | $1.60 |

You can cap any run with **Maximum cost per run**; the run stops at the cap and says so.

### Integrations, API, scheduling & MCP

- **Schedule** the actor daily in Apify Console (Schedules) and turn on **Only new or updated creators** - Social Blade updates once a day.
- **Webhooks** send the finished dataset to your app; connect **Make, Zapier, n8n, Google Sheets, Slack** or **Airbyte** from the Integrations tab.
- **API**: run it from [Python](https://apify.com/topapi/socialblade-scraper/api/python) or [JavaScript](https://apify.com/topapi/socialblade-scraper/api/javascript) with `apify-client`, or call the REST endpoint.
- **MCP**: add the actor to Claude, Cursor or any MCP client through the [Apify MCP server](https://apify.com/topapi/socialblade-scraper/api/mcp).

### More creator scrapers

- [TikTok Scraper](https://apify.com/topapi/tiktok-scraper) - videos, hashtags, profiles and transcripts.
- [TikTok User Search Scraper](https://apify.com/topapi/tiktok-user-search-scraper) - find TikTok creators with followers, bio links and emails.
- [Instagram Profile Scraper](https://apify.com/topapi/instagram-profile-scraper) - followers, bio and engagement straight from Instagram.
- [Instagram Scraper](https://apify.com/topapi/instagram-scraper) - posts, reels, hashtags and profiles.
- [YouTube Shorts Scraper](https://apify.com/topapi/youtube-shorts-scraper) - Shorts views, channels, hashtags and transcripts.
- [Facebook Posts Scraper](https://apify.com/topapi/facebook-page-posts-scraper) - page posts, reactions and transcripts.

More from [TopApi](https://apify.com/topapi).

### Limits & empty runs

- **History depth:** Social Blade shows the last 15 days to visitors without an account, so growth windows stop at 14 days and earnings and projections average those days (`basis_days`). 30-365-day windows, Social Blade's own projections and older history are member features and are not in the rows.
- **Instagram:** Social Blade keeps Instagram history for paying members; Instagram rows have profile, engagement and ranks, `history_available: false`.
- **Rankings:** up to 100 rows per list; growth / decline over 1 or 3 days; "bottom" lists are not served to visitors.
- **Rounded subscribers:** YouTube rounds subscriber counts (524M), so daily subscriber gains move in steps.
- **Speed:** 100 full profiles in 29 s; 1,000 in about 8 minutes; 1,000 ranking rows in 14 s (measured).
- **Never charged:** creators Social Blade does not have, inputs skipped with a reason, rows removed by your filters, unchanged creators in monitor mode, and anything Social Blade did not answer. Every empty run ends with a status message saying which of these happened.

### ❓ FAQ

#### How much does Social Blade Scraper cost?

$0.0016 per creator row ($1.60 per 1,000), with history, growth, earnings and projections included; YouTube milestones are $0.0008 extra per channel. No start fee.

#### How many results can Social Blade Scraper return?

As many creators as you give it, plus up to 100 rows per Social Blade ranking and up to 25 per search term. Set `maxItems` to cap a run.

#### Can I monitor creators with Social Blade Scraper on a schedule?

Yes. Turn on **Only new or updated creators**, give the watch list a store name and schedule the actor daily; each run delivers only creators with a new Social Blade day, with `audience_change_since_last_run`.

#### Does Social Blade Scraper need a Social Blade account or API key?

No. It reads the pages Social Blade shows to every visitor, with no login, cookies or API key.

#### Which platforms does Social Blade Scraper cover?

YouTube, TikTok, Instagram, Twitch and Facebook - the platforms socialblade.com has pages for today.

#### How are the YouTube earnings estimated?

With Social Blade's own method: views gained / 1,000 x a CPM range of $0.25 to $4. Change the range with `cpmMinUsd` / `cpmMaxUsd` and the currency with `earningsCurrency`.

#### Can I use Social Blade Scraper with the Apify API or an MCP server?

Yes - through `apify-client` for Python or JavaScript, the REST API, webhooks, or the Apify MCP server for AI agents.

#### Why did Social Blade Scraper return no results?

The status message says why: the creator is not on Social Blade (check the spelling and the platform), your filters removed everything, or in monitor mode nothing changed since the last run. None of these is charged.

#### Your feedback

Found a bug or need a field? Open an issue on the [Issues tab](https://apify.com/topapi/socialblade-scraper/issues/open) and we will look at it.

# Actor input Schema

## `profiles` (type: `array`):

Creators to look up: Social Blade links, YouTube / TikTok / Instagram / Twitch / Facebook links, "platform:handle" (e.g. "tiktok:khaby.lame"), @handles or YouTube channel ids. Bare handles use the platform below.

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

Platform of a creator given without a link or prefix ("mrbeast"), and of the search terms. "All platforms" looks a bare handle up on all five.

## `searchQueries` (type: `array`):

Names to look up in Social Blade's own search (e.g. "veritasium", "cooking"); each match becomes a full creator row.

## `resultsPerQuery` (type: `integer`):

Creators taken from each search (Social Blade returns up to 25 on YouTube and 5 elsewhere).

## `rankingPlatform` (type: `string`):

Pull one of Social Blade's rankings (top 100 lists). Leave on "No ranking" to skip.

## `rankingType` (type: `string`):

Top = biggest by the metric; Growth / Decline = most gained or lost over the period below.

## `rankingMetric` (type: `string`):

YouTube: subscribers, views, videos · TikTok: followers, likes · Instagram: followers, posts · Twitch: followers · Facebook: likes, talking about. Empty = the platform's audience.

## `rankingCategory` (type: `string`):

YouTube channel category for a top list.

## `rankingCountry` (type: `string`):

Two-letter country code (e.g. "US", "IN", "BR") or "global".

## `rankingPeriod` (type: `string`):

Days the gain or loss is measured over (Social Blade serves 1 and 3 days to visitors without an account).

## `rankingLimit` (type: `integer`):

How many creators of the ranking to deliver (Social Blade serves up to 100).

## `rankingMadeForKids` (type: `string`):

Social Blade's own made-for-kids filter on a YouTube top list.

## `listUrls` (type: `array`):

Social Blade ranking pages to read as they are, e.g. https://socialblade.com/youtube/lists/top/100/subscribers/games/US.

## `enrichRankings` (type: `boolean`):

Open each ranked creator's page for grade, ranks, history, earnings and projections (one page per creator; same price per row).

## `includeHistory` (type: `boolean`):

The day-by-day table (totals and daily gains) Social Blade shows without an account: the last 15 days. Not available for Instagram.

## `historyDays` (type: `integer`):

Most recent days kept in the table (1-15). Growth windows always use every served day.

## `historySince` (type: `string`):

Keep only days on or after this date in the table (YYYY-MM-DD), e.g. the day of your last scheduled run.

## `includeEarnings` (type: `boolean`):

Social Blade's own formula: views gained / 1,000 x a CPM range ($0.25 - $4 by default), daily and for week, month, quarter, half year and year.

## `earningsCurrency` (type: `string`):

Three-letter code (e.g. USD, EUR, GBP, INR), converted with the exchange rates Social Blade's page carries.

## `cpmMinUsd` (type: `number`):

Low end of the revenue per 1,000 views (Social Blade's default 0.25).

## `cpmMaxUsd` (type: `number`):

High end of the revenue per 1,000 views (Social Blade's default 4).

## `includeProjections` (type: `boolean`):

Audience, views and uploads in 30 days to 5 years, plus the next round-number milestone date, from the average daily gain of the served days.

## `includeMilestones` (type: `boolean`):

Add the date each subscriber, view and upload milestone was reached and the first day Social Blade tracked the channel (one more page per channel). Charged only when delivered.

## `minAudience` (type: `integer`):

Skip creators with fewer subscribers (YouTube), followers (TikTok, Instagram, Twitch) or page likes (Facebook).

## `maxAudience` (type: `integer`):

Skip creators above this audience (e.g. 1000000 for micro-influencers).

## `minGrade` (type: `string`):

Keep creators graded at least this (A++ is the best). Ranking rows carry no grade unless full profiles are on.

## `countries` (type: `array`):

Keep only creators from these countries (two-letter codes, e.g. US, GB). YouTube only - other platforms carry no country.

## `categories` (type: `array`):

Keep only YouTube channels of these categories (e.g. games, music, education, tech).

## `verifiedOnly` (type: `boolean`):

Keep only creators Social Blade marks verified (TikTok, Twitch, Facebook).

## `madeForKids` (type: `string`):

Keep, drop or keep only YouTube channels marked made for kids.

## `monitorMode` (type: `boolean`):

Deliver a creator only when Social Blade has a newer day (or new totals) than your last run delivered; rows carry the change since then. Pairs with a daily schedule.

## `monitorOutput` (type: `string`):

What a monitor run delivers.

## `monitorStoreName` (type: `string`):

Named key-value store that remembers what was delivered. Use one name per watch list.

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

Most creator rows to deliver (profiles + ranking rows). 0 = no limit.

## `compact` (type: `boolean`):

Core columns only (name, grade, audience, views, rank, gain per day, earnings) - handy for AI agents and spreadsheets.

## `proxyConfiguration` (type: `object`):

Optional. The actor already falls back from its own address to Apify datacenter and residential exits when Social Blade refuses one; set a proxy here to use yours first.

## `maxConcurrency` (type: `integer`):

Pages read at the same time.

## Actor input object example

```json
{
  "profiles": [
    "https://socialblade.com/youtube/handle/mrbeast",
    "tiktok:khaby.lame",
    "twitch:kaicenat"
  ],
  "platform": "youtube",
  "resultsPerQuery": 5,
  "rankingPlatform": "",
  "rankingType": "top",
  "rankingMetric": "",
  "rankingCategory": "all",
  "rankingCountry": "global",
  "rankingPeriod": "3",
  "rankingLimit": 100,
  "rankingMadeForKids": "any",
  "enrichRankings": false,
  "includeHistory": true,
  "historyDays": 15,
  "includeEarnings": true,
  "earningsCurrency": "USD",
  "cpmMinUsd": 0.25,
  "cpmMaxUsd": 4,
  "includeProjections": true,
  "includeMilestones": false,
  "minGrade": "",
  "verifiedOnly": false,
  "madeForKids": "any",
  "monitorMode": false,
  "monitorOutput": "changes",
  "monitorStoreName": "socialblade-monitor",
  "maxItems": 50,
  "compact": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxConcurrency": 4
}
```

# Actor output Schema

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

One item per creator profile or ranking row (the type field says which).

## `summary` (type: `string`):

Per-source counts, not-found and unreachable inputs, filtered counts, routes used, field fill and charges.

# 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 = {
    "profiles": [
        "https://socialblade.com/youtube/handle/mrbeast",
        "tiktok:khaby.lame",
        "twitch:kaicenat"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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 = {
    "profiles": [
        "https://socialblade.com/youtube/handle/mrbeast",
        "tiktok:khaby.lame",
        "twitch:kaicenat",
    ],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/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 '{
  "profiles": [
    "https://socialblade.com/youtube/handle/mrbeast",
    "tiktok:khaby.lame",
    "twitch:kaicenat"
  ],
  "maxItems": 50
}' |
apify call topapi/socialblade-scraper --silent --output-dataset

```

## MCP server setup

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