# Social Blade Scraper — YouTube, TikTok, Instagram & Twitch (`amrameng/socialblade-scraper`) Actor Free Social Blade scraper for YouTube, TikTok, Twitch, Instagram and Facebook. Get subscribers, followers, views, ranks, grades, daily history, growth and earnings estimates — look up creators or discover top creators by country and category. No login or API key. - **URL**: https://apify.com/amrameng/socialblade-scraper.md - **Developed by:** [Amram Englander](https://apify.com/amrameng) (community) - **Categories:** Social media, Marketing, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 The **Social Blade Scraper** extracts public creator statistics from [Social Blade](https://socialblade.com) for **YouTube, TikTok, Twitch, Instagram, and Facebook**. For every creator you get a complete snapshot — subscribers or followers, total views, uploads, the Social Blade **letter grade**, global/country/category **ranks**, linked social accounts, up to **31 days of daily history**, **growth over time**, and **earnings estimates** — all in one structured dataset you can export to JSON, CSV, or Excel. It's the only Social Blade Actor on Apify that does both jobs in one place: **look up the exact creators you name**, and **discover the top creators across all five platforms**. ### What does the Social Blade Scraper do? This Actor scrapes public creator statistics from Social Blade and outputs them as a unified, cross-platform dataset you can export to JSON, CSV, Excel, or HTML, or pull straight from the Apify API. - **Two modes in one Actor** — *Look up specific creators* by handle/URL, or *Discover top creators* via ranked leaderboards. - **All five platforms** — YouTube, TikTok, Twitch, Instagram, and Facebook, side by side in a single run. - **Profile + history + growth + earnings** — full snapshot, up to 31 days of daily history, 1/7/14/30-day growth deltas, and YouTube earnings estimates. - **No login, no API key, no paid Social Blade account** — reads only publicly visible data. It does **not** scrape private or Social Blade Pro–only data, and it does not require your Social Blade credentials. ### Why use the Social Blade Scraper? - 🏆 **Ranked leaderboards on every platform** — discover the top creators on YouTube, TikTok, Twitch, Instagram, and Facebook. - 📈 **Derived metrics included** — pre-computed growth deltas and earnings estimates, not just raw counts. - 🔎 **Influencer discovery & vetting** — shortlist creators by grade, audience size, and 30-day growth; spot paid-follower red flags via flat daily history. - 💰 **Sponsorship & campaign pricing** — sanity-check rate cards against independent earnings and rank tiers; build nano/micro/mid/macro creator tiers. - 📊 **Creator-economy research** — track audience and view growth across the top creators in any category and country; compare cross-platform reach for one creator. - 📅 **Competitive & cohort tracking** — schedule a fixed creator list weekly to build history beyond 31 days and surface rank/grade momentum shifts. - 🎯 **Lead generation for talent agencies** — build country-filtered shortlists of creators above a follower threshold with verification signals. ### What data can the Social Blade Scraper extract? One unified record per creator. Key fields: | Field | Type | Description | |---|---|---| | `platform` | string | `youtube`, `tiktok`, `twitch`, `instagram`, or `facebook` | | `id` | string | Social Blade's internal creator ID (YouTube channel ID, numeric elsewhere) | | `displayName` / `username` | string | Public name and handle | | `url` | string | Canonical Social Blade profile URL | | `country` | string | Two-letter country code | | `category` | string | Channel category as Social Blade classifies it | | `grade` | string | Social Blade letter grade (e.g. `A++`, `B+`) | | `followers` | number | Unified audience — subscribers (YouTube), followers, or page likes (Facebook) | | `totalViews` | number | Total channel views (YouTube) | | `mediaCount` | number | Uploads / media count / posts | | `engagementRate` | number | Engagement rate (Instagram) | | `ranks` | object | Global (`sb`), audience, views, country, and category ranks | | `socials` | array | Linked social accounts on other platforms | | `history` | array | Up to 31 daily snapshots (date + per-day metrics) | | `growth` | object | 1/7/14/30-day change, absolute and percent | | `earnings` | object | Estimated monthly/yearly USD earnings (YouTube) | | `rankingContext` | object | In leaderboard mode: position, metric, country, category | ### How to scrape Social Blade 1. Click **Try for free** / **Start**. 2. Choose a **mode**: *Look up specific creators* or *Discover top creators*. 3. **Look-up mode** — paste creator handles or Social Blade URLs (one per line) and pick a default platform for bare handles. 4. **Rankings mode** — select one or more **platforms**, a metric (or leave **Rank by: Auto**), a list size, and optional **countries**/**categories** (YouTube). 5. Toggle **daily history**, **growth deltas**, and **earnings estimates** as needed. 6. Click **Save & Start**, then download results as JSON, CSV, Excel, or HTML — or fetch them via the Apify API. #### Look up specific creators ```json { "mode": "profiles", "profiles": ["@mrbeast", "twitch/ninja", "instagram/cristiano", "tiktok/charlidamelio", "facebook/Coca-Cola"], "defaultPlatform": "youtube", "includeHistory": true, "historyDays": 31, "includeGrowth": true, "includeEarnings": true } ```` #### Discover top creators (ranked leaderboards) ```json { "mode": "rankings", "rankingPlatforms": ["youtube", "tiktok"], "rankBy": "auto", "rankSort": "desc", "rankLimit": "100", "rankCountries": ["global", "US"], "rankCategories": ["games", "music"] } ``` ### How much does it cost to scrape Social Blade? You pay **per creator result** — there's no charge for empty runs, and small look-ups cost only a few cents. A single profile (with or without 31 days of history) counts as **one result**, so a 100-creator run is 100 results. In **rankings mode**, results multiply across platforms × countries × categories × list size, so use **Maximum results** as a safety cap on larger discovery runs. See the **Pricing** tab for the current per-result rate; the Apify free tier is enough to trial the Actor at no cost. ### Input See the **Input** tab for the full, guided configuration form — every constrained field is a dropdown or multi-select, so valid values are always one click away. Key fields: - **Mode** — look up known creators, or discover top creators. - **Creator handles or URLs** + **Default platform** (look-up mode). - **Platforms**, **Rank by**, **Order**, **How many per list**, **Countries**, **Categories**, **Made-for-kids** (rankings mode). - **Include daily history** / **Days of history** (max 31), **Include growth deltas**, **Include earnings estimates**. - **Maximum results** and **Proxy**. ### Output You can download the dataset in various formats such as **JSON, CSV, Excel, or HTML**, or fetch it via the Apify API. Example records: ```json [ { "platform": "youtube", "id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "displayName": "MrBeast", "url": "https://socialblade.com/youtube/channel/UCX6OQ3DkcsbYNE6H8uQQuVA", "country": "US", "category": "entertainment", "grade": "A++", "followers": 496000000, "totalViews": 127485459513, "mediaCount": 985, "ranks": { "sb": 2, "subscribers": 1, "views": 6, "country": 1, "category": 1 }, "growth": { "subscribers": [{ "days": 30, "absolute": 14000000, "percent": 2.9 }] }, "earnings": { "currency": "USD", "monthly": { "min": 1755544, "max": 28088699 } }, "scrapedAt": "2026-06-06T00:00:00.000Z" }, { "platform": "tiktok", "id": "5831967", "displayName": "charli d'amelio", "url": "https://socialblade.com/tiktok/user/charlidamelio", "grade": "A++", "followers": 158300000, "mediaCount": 3147, "ranks": { "sb": 43, "followers": 2, "likes": 1 } } ] ``` `followers` is the unified audience count for every platform; fields a platform doesn't provide are returned as `null`. ### Tips for best results - Keep **history off** for large pure-discovery runs to keep them fast and cheap; turn it on when you need trends, growth, or earnings. - For YouTube, a `@handle`, channel URL, or `UC…` ID all work — the Actor resolves handles automatically. - Country and category filters apply to **YouTube only** (that's all Social Blade ranks by region); they're ignored for other platforms. - Use **Maximum results** to cap cost on multi-country/category leaderboards. - Schedule the Actor daily to accumulate history longer than Social Blade's 31-day public window. ### How this Actor compares to other Social Blade scrapers | Capability | This Actor | Typical alternative | |---|---|---| | Ranked leaderboards | **All 5 platforms** | YouTube only, or none | | Country filter | **250+ codes, multi-select, friendly names** | ~17 codes, single-select, or a free-text box | | Category filter | **All 16, validated against the live API** | Partial / contains invalid options | | Input style | **Guided dropdowns & multi-selects** | Raw codes / JSON / free text | | Look-up + discovery | **Both modes** | One or the other | | Growth & earnings | **Included** | Sometimes | ### FAQ **How does the Social Blade Scraper work?** It reads the public Social Blade pages and their underlying data for each creator, then normalizes everything into one cross-platform schema. No login or API key is required. **Do I need a Social Blade account or API key?** No. The Actor uses only publicly available data. **Which platforms are supported?** YouTube, TikTok, Twitch, Instagram, and Facebook. **Can I scrape top creator lists, not just individual profiles?** Yes — switch to *Discover top creators* mode and pick platforms, countries, and categories. **How much history can I get?** Social Blade exposes about **31 days** of daily history to anonymous visitors, so history is capped at 31 days. Schedule the Actor to build longer histories over time. **How accurate are the earnings estimates?** They're *estimates* computed the same way Social Blade does — recent view growth × a CPM range — and are provided for YouTube. Treat them as a directional range, not exact revenue. **Can I schedule automatic runs and use the API?** Yes. Use Apify's scheduler, REST API, and integrations (Make, Zapier, Slack, Google Sheets, webhooks). ### Is it legal to scrape Social Blade? Web scraping of public data is legal in many jurisdictions, but you are responsible for how you use the data and for complying with Social Blade's Terms of Service. > Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. 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. ### Support Found a bug or want a new feature? Open an issue on the **Issues** tab — we actively maintain this Actor. For programmatic use, see the **API** tab. # Actor input Schema ## `mode` (type: `string`): Choose how the run finds creators. **Look up specific creators** = you paste handles/URLs. **Discover top creators** = we pull ranked leaderboards you filter by platform, country and category. ## `profiles` (type: `array`): One creator per line. Accepts a full Social Blade URL (e.g. `https://socialblade.com/youtube/user/pewdiepie`), a platform handle (`@pewdiepie`, `ninja`, `cristiano`) or a YouTube channel ID (`UC-...`). YouTube handles are resolved to the channel automatically. Used in **Look up specific creators** mode. ## `defaultPlatform` (type: `string`): If a line above is just a handle with no platform (e.g. `mrbeast`), which platform should we assume? Lines that are full Social Blade URLs ignore this. ## `rankingPlatforms` (type: `array`): Which platforms to pull leaderboards for. Pick one or several — we fetch a ranked list for each. Used in **Discover top creators** mode. ## `rankBy` (type: `string`): Metric to sort the leaderboard by. **Auto** uses each platform's primary metric (YouTube = subscribers, Twitch/Instagram/TikTok = followers, Facebook = likes). If you pick a metric a selected platform doesn't support, that platform falls back to Auto. ## `rankSort` (type: `string`): Sort the leaderboard with the highest value first (top creators) or lowest first. ## `rankLimit` (type: `string`): Number of creators per leaderboard. Note: this multiplies — Top 100 with 2 platforms × 3 countries = up to 600 results. ## `rankCountries` (type: `array`): Filter the YouTube leaderboard by creator country. Leave as **Global** for worldwide. Pick several to pull a separate list per country. Ignored for non-YouTube platforms (Social Blade only offers country ranking on YouTube). ## `rankCategories` (type: `array`): Filter the YouTube leaderboard by content category. Leave as **All** for no filter. Pick several to pull a separate list per category. Ignored for non-YouTube platforms. ## `madeForKids` (type: `string`): YouTube only: include all channels, exclude “made for kids” channels, or return only “made for kids” channels. ## `includeHistory` (type: `boolean`): Add a per-day time series (subscribers/followers, views, etc.) to every creator. ## `historyDays` (type: `integer`): How many days of daily history to return per creator. Social Blade caps anonymous history at **31 days**, so values above 31 return the maximum available. ## `includeGrowth` (type: `boolean`): Add 1 / 7 / 14 / 30-day growth (absolute and %), computed from the daily history. Requires history. ## `includeEarnings` (type: `boolean`): Add estimated monthly/yearly earnings in USD for YouTube channels, derived from recent view growth and Social Blade’s CPM ranges (Social Blade does not return this directly — it is computed the same way the website does). ## `maxResults` (type: `integer`): Hard cap on total creators written to the dataset across all platforms/countries/categories. Protects you from accidental large/expensive runs. Leave empty for no cap. ## `proxyConfiguration` (type: `object`): Social Blade is behind Cloudflare; a proxy with a browser-like fingerprint is required. Apify Proxy (datacenter) works by default; switch to residential if you see blocks. ## Actor input object example ```json { "mode": "profiles", "profiles": [ "@mrbeast", "ninja", "cristiano" ], "defaultPlatform": "youtube", "rankingPlatforms": [ "youtube" ], "rankBy": "auto", "rankSort": "desc", "rankLimit": "100", "rankCountries": [ "global" ], "rankCategories": [ "all" ], "madeForKids": "all", "includeHistory": true, "historyDays": 31, "includeGrowth": true, "includeEarnings": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "profiles": [ "@mrbeast", "ninja", "cristiano" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("amrameng/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "profiles": [ "@mrbeast", "ninja", "cristiano", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("amrameng/socialblade-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": [ "@mrbeast", "ninja", "cristiano" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call amrameng/socialblade-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=amrameng/socialblade-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Social Blade Scraper — YouTube, TikTok, Instagram & Twitch", "description": "Free Social Blade scraper for YouTube, TikTok, Twitch, Instagram and Facebook. Get subscribers, followers, views, ranks, grades, daily history, growth and earnings estimates — look up creators or discover top creators by country and category. No login or API key.", "version": "0.1", "x-build-id": "cBKAsIje92Jjg90cL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/amrameng~socialblade-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-amrameng-socialblade-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/amrameng~socialblade-scraper/runs": { "post": { "operationId": "runs-sync-amrameng-socialblade-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/amrameng~socialblade-scraper/run-sync": { "post": { "operationId": "run-sync-amrameng-socialblade-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "What do you want to do?", "enum": [ "profiles", "rankings" ], "type": "string", "description": "Choose how the run finds creators. **Look up specific creators** = you paste handles/URLs. **Discover top creators** = we pull ranked leaderboards you filter by platform, country and category.", "default": "profiles" }, "profiles": { "title": "Creator handles or URLs", "type": "array", "description": "One creator per line. Accepts a full Social Blade URL (e.g. `https://socialblade.com/youtube/user/pewdiepie`), a platform handle (`@pewdiepie`, `ninja`, `cristiano`) or a YouTube channel ID (`UC-...`). YouTube handles are resolved to the channel automatically. Used in **Look up specific creators** mode.", "items": { "type": "string" } }, "defaultPlatform": { "title": "Default platform for bare handles", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "type": "string", "description": "If a line above is just a handle with no platform (e.g. `mrbeast`), which platform should we assume? Lines that are full Social Blade URLs ignore this.", "default": "youtube" }, "rankingPlatforms": { "title": "Platforms", "type": "array", "description": "Which platforms to pull leaderboards for. Pick one or several — we fetch a ranked list for each. Used in **Discover top creators** mode.", "items": { "type": "string", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "enumTitles": [ "YouTube", "TikTok", "Twitch", "Instagram", "Facebook" ] }, "default": [ "youtube" ] }, "rankBy": { "title": "Rank by", "enum": [ "auto", "subscribers", "views", "videos", "followers", "likes", "posts", "talking_about" ], "type": "string", "description": "Metric to sort the leaderboard by. **Auto** uses each platform's primary metric (YouTube = subscribers, Twitch/Instagram/TikTok = followers, Facebook = likes). If you pick a metric a selected platform doesn't support, that platform falls back to Auto.", "default": "auto" }, "rankSort": { "title": "Order", "enum": [ "desc", "asc" ], "type": "string", "description": "Sort the leaderboard with the highest value first (top creators) or lowest first.", "default": "desc" }, "rankLimit": { "title": "How many per list", "enum": [ "10", "50", "100", "250", "500", "1000", "5000" ], "type": "string", "description": "Number of creators per leaderboard. Note: this multiplies — Top 100 with 2 platforms × 3 countries = up to 600 results.", "default": "100" }, "rankCountries": { "title": "Countries (YouTube only)", "type": "array", "description": "Filter the YouTube leaderboard by creator country. Leave as **Global** for worldwide. Pick several to pull a separate list per country. Ignored for non-YouTube platforms (Social Blade only offers country ranking on YouTube).", "items": { "type": "string", "enum": [ "global", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AC", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "IC", "CV", "BQ", "KY", "CF", "EA", "TD", "CL", "CN", "CX", "CP", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "TP", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GZ", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "WS", "SM", "ST", "SA", "SN", "RS", "CS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TA", "TN", "TR", "TM", "TC", "TV", "UM", "VI", "UG", "UA", "AE", "UK", "GB", "US", "XX", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZH", "ZW" ], "enumTitles": [ "🌍 Global (all countries)", "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua & Barbuda", "Argentina", "Armenia", "Aruba", "Ascension Island", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia & Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Canary Islands", "Cape Verde", "Caribbean Netherlands", "Cayman Islands", "Central African Republic", "Ceuta & Melilla", "Chad", "Chile", "China", "Christmas Island", "Clipperton Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo - Brazzaville", "Congo - Kinshasa", "Cook Islands", "Costa Rica", "Côte d’Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czechia", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Gaza Strip", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard & McDonald Islands", "Honduras", "Hong Kong SAR China", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao SAR China", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar (Burma)", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestinian Territories", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar", "Réunion", "Romania", "Russia", "Rwanda", "Samoa", "San Marino", "São Tomé & Príncipe", "Saudi Arabia", "Senegal", "Serbia", "Serbia & Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia & South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "St. Barthélemy", "St. Helena", "St. Kitts & Nevis", "St. Lucia", "St. Martin", "St. Pierre & Miquelon", "St. Vincent & Grenadines", "Sudan", "Suriname", "Svalbard & Jan Mayen", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad & Tobago", "Tristan da Cunha", "Tunisia", "Türkiye", "Turkmenistan", "Turks & Caicos Islands", "Tuvalu", "U.S. Outlying Islands", "U.S. Virgin Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United Kingdom", "United States", "Unknown", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis & Futuna", "Western Sahara", "Yemen", "Zambia", "ZH", "Zimbabwe" ] }, "default": [ "global" ] }, "rankCategories": { "title": "Categories (YouTube only)", "type": "array", "description": "Filter the YouTube leaderboard by content category. Leave as **All** for no filter. Pick several to pull a separate list per category. Ignored for non-YouTube platforms.", "items": { "type": "string", "enum": [ "all", "games", "entertainment", "people", "animals", "film", "music", "sports", "tech", "howto", "news", "education", "comedy", "nonprofit", "autos", "travel", "shows" ], "enumTitles": [ "All categories", "Games", "Entertainment", "People & Blogs", "Animals & Pets", "Film & Animation", "Music", "Sports", "Science & Tech", "Howto & Style", "News & Politics", "Education", "Comedy", "Nonprofit & Activism", "Autos & Vehicles", "Travel & Events", "Shows" ] }, "default": [ "all" ] }, "madeForKids": { "title": "Made-for-kids channels (YouTube only)", "enum": [ "all", "exclude", "only" ], "type": "string", "description": "YouTube only: include all channels, exclude “made for kids” channels, or return only “made for kids” channels.", "default": "all" }, "includeHistory": { "title": "Include daily history", "type": "boolean", "description": "Add a per-day time series (subscribers/followers, views, etc.) to every creator.", "default": true }, "historyDays": { "title": "Days of history", "minimum": 1, "maximum": 31, "type": "integer", "description": "How many days of daily history to return per creator. Social Blade caps anonymous history at **31 days**, so values above 31 return the maximum available.", "default": 31 }, "includeGrowth": { "title": "Include growth deltas", "type": "boolean", "description": "Add 1 / 7 / 14 / 30-day growth (absolute and %), computed from the daily history. Requires history.", "default": true }, "includeEarnings": { "title": "Include earnings estimates", "type": "boolean", "description": "Add estimated monthly/yearly earnings in USD for YouTube channels, derived from recent view growth and Social Blade’s CPM ranges (Social Blade does not return this directly — it is computed the same way the website does).", "default": true }, "maxResults": { "title": "Maximum results (safety cap)", "minimum": 1, "type": "integer", "description": "Hard cap on total creators written to the dataset across all platforms/countries/categories. Protects you from accidental large/expensive runs. Leave empty for no cap." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Social Blade is behind Cloudflare; a proxy with a browser-like fingerprint is required. Apify Proxy (datacenter) works by default; switch to residential if you see blocks.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```