# SocialBlade Scraper - Creator Stats and History (`benthepythondev/socialblade-scraper`) Actor Scrape public SocialBlade profiles for YouTube, TikTok, Instagram and Twitch with audience counts, grades, ranks, profile data and 15-day histories. - **URL**: https://apify.com/benthepythondev/socialblade-scraper.md - **Developed by:** [Ben](https://apify.com/benthepythondev) (community) - **Categories:** Social media, Marketing, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.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 ## SocialBlade Scraper - Creator Stats, Ranks and 15-Day History Collect structured public creator statistics from SocialBlade without copying profile pages into a spreadsheet. SocialBlade Scraper accepts public YouTube, TikTok, Instagram, and Twitch profile URLs and returns creator identity, audience size, platform-specific statistics, SocialBlade grade and ranks, profile metadata, and up to 15 days of public history. The Actor is designed for creator research, sponsorship qualification, social-media monitoring, market analysis, agency databases, and repeatable public profile snapshots. Every valid profile is saved as one row in the Apify default dataset. Results can be exported to JSON, CSV, Excel, XML, or RSS, called through the Apify API, scheduled, sent to a webhook, or connected to Make, Zapier, n8n, Airtable, Google Sheets, and a data warehouse. ### Supported SocialBlade profiles The current version supports public profile URLs for: - YouTube channels by handle, channel ID, custom URL, or other SocialBlade-supported channel path. - TikTok users. - Instagram users. - Twitch users. The Actor validates that each URL points to `socialblade.com` and starts with a supported platform path. This prevents unrelated URLs from being requested and keeps the input contract clear. ### What data can it collect? Fields vary by platform, but the normalized output can include: - Platform, creator ID, username, display name, and canonical SocialBlade URL. - Avatar and banner image URLs. - Public description, website, country, category, and account creation time. - SocialBlade grade. - Followers or subscribers, normalized as `audience_count` for cross-platform sorting. - Following, views, video count, media count, and likes when available. - Instagram engagement rate, average likes, and average comments when exposed. - Verification and made-for-kids indicators when relevant. - SocialBlade global, audience, views, country, and category ranks. - Public identifiers and social links. - A normalized daily history array for up to 15 days. - UTC scrape timestamp. Missing upstream fields remain empty. The Actor does not estimate hidden values or force one platform's metric into an unrelated field. ### Common use cases #### Creator and influencer research Build a comparable table of public creators from several platforms. Use audience, grade, ranks, description, category, history, and profile links as inputs to a manual qualification process. Public follower counts and SocialBlade grades do not prove audience authenticity, demographics, brand safety, or partnership suitability. #### Historical audience monitoring Run the same profile list weekly and retain every dataset. The included `history` array provides recent daily values, while `scraped_at` identifies the observation time. Append snapshots instead of overwriting prior records if you need longer-term analysis. #### Sponsorship shortlist enrichment Agencies can add SocialBlade data to an internally reviewed creator list. Keep source fields separate from your manual territory, content-quality, brand-fit, contact, and campaign columns. #### Competitive and category analysis Compare creators in a focused niche by public audience, grade, category rank, and recent change. Avoid comparing metrics that have different meanings: a Twitch follower is not the same behavior as a YouTube subscriber or Instagram follower. #### Change alerts Use a scheduled run plus n8n or Make to alert when a selected creator's audience, grade, rank, description, or public profile status changes beyond a chosen threshold. ### Input Provide one or more public SocialBlade profile URLs. ```json { "profileUrls": [ {"url": "https://socialblade.com/youtube/handle/mkbhd"}, {"url": "https://socialblade.com/tiktok/user/khaby.lame"}, {"url": "https://socialblade.com/instagram/user/cristiano"}, {"url": "https://socialblade.com/twitch/user/shroud"} ], "maxProfiles": 10 } ```` #### Input fields | Field | Type | Description | | --- | --- | --- | | `profileUrls` | array | Public SocialBlade profile URLs for YouTube, TikTok, Instagram, or Twitch. | | `maxProfiles` | integer | Maximum supplied profiles processed in one run. Default: 10. Maximum: 100. | Duplicate URLs are processed once. Start with a small batch to verify that the supplied SocialBlade paths resolve to the creators you intend. SocialBlade's older `/user/` aliases can sometimes redirect; prefer current handle or channel-ID URLs when available. ### Output Each dataset item represents one public creator profile. ```json { "platform": "youtube", "id": "UCBJycsmduvYEL83R_U4JriQ", "username": "mkbhd", "display_name": "Marques Brownlee", "profile_url": "https://socialblade.com/youtube/handle/mkbhd", "avatar_url": "https://yt3.ggpht.com/example", "banner_url": "https://yt3.googleusercontent.com/example", "description": "MKBHD: Quality Tech Videos", "website_url": null, "country": "US", "channel_type": "tech", "created_at": "2008-03-21T00:00:00.000Z", "grade": "B+", "audience_count": 21100000, "followers": null, "subscribers": 21100000, "following": null, "views": 5474927402, "videos": 1835, "media_count": null, "likes": null, "engagement_rate": null, "average_likes": null, "average_comments": null, "verified": false, "made_for_kids": false, "sb_rank": 30290, "audience_rank": 317, "views_rank": 3262, "country_rank": 149, "category_rank": 10, "identifiers": [], "social_links": [], "history": [ { "date": "2026-07-10T00:00:00.000Z", "followers": null, "subscribers": 21100000, "following": null, "views": 5474261308, "likes": null, "videos": 1835 } ], "history_days": 15, "scraped_at": "2026-07-11T11:00:00+00:00" } ``` SocialBlade's page fields differ across platforms. TikTok history can contain followers, following, likes, and videos. Twitch history may contain only followers. Instagram can expose engagement fields but no daily history on some profiles. The Actor preserves those differences rather than manufacturing uniform values. ### Pricing SocialBlade Scraper uses pay per event pricing: - Actor start: $0.00005 per run. - Result: $0.003 for each creator profile saved to the default dataset. A 10-profile run costs about $0.03005 in Actor charges, excluding ordinary Apify platform usage. A 100-profile run costs about $0.30005. You pay only for profiles actually saved. Invalid, unavailable, or unsupported URLs that produce no row are not billed as result events. ### Run through the Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/benthepythondev~socialblade-scraper/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"profileUrls":[{"url":"https://socialblade.com/youtube/handle/mkbhd"}],"maxProfiles":1}' ``` The response contains a run ID. Poll it until the run succeeds, then read the default dataset URL. Keep tokens in Apify secrets or another secret manager and never commit them to public source code. ### Automation ideas #### Weekly creator snapshot Schedule a reviewed profile list once per week. Save each result with `scraped_at`, platform, creator ID, audience count, grade, and ranks. Do not overwrite the prior snapshot. #### Cross-platform research table Map `platform`, `id`, `username`, `display_name`, `audience_count`, `profile_url`, and `scraped_at` into a shared table. Preserve the full Actor row as source-specific JSON for platform-level fields. #### Rank and grade alerts Compare the current record with the previous one. Send an alert only when a grade changes or a rank moves beyond a meaningful threshold. This avoids notifications for normal daily fluctuations. #### History expansion Use n8n or Python to expand the `history` array into a separate daily table keyed by platform, creator ID, and date. Deduplicate those keys before inserting. ### Reliability and technical approach The Actor loads public SocialBlade profile pages with a Chrome-compatible HTTP client and reads the structured Next.js state already embedded by the server. It does not launch a full browser, log into SocialBlade, use residential proxy traffic, or consume paid unblocker credits. This keeps runs fast and inexpensive. Requests use bounded retries and timeouts. Inputs are validated and deduplicated. The profile and history records are selected by their platform-specific public query keys. If no valid profile rows are returned, the run fails explicitly instead of appearing successful with an empty dataset. This makes upstream changes visible in schedules and monitoring. SocialBlade can revise its page or query structure. Monitor production schedules and report a reproducible failure with the Apify run ID and one public example URL. ### Data quality and limitations - SocialBlade metrics are public source values observed at collection time. - Audience counts can be rounded or updated on the source's own schedule. - Grades and ranks are SocialBlade's methodology, not an independent recommendation. - A daily history value may repeat when the upstream platform reports rounded counts. - Estimated earnings are intentionally not normalized because they are broad estimates and easy to misinterpret. - Private, deleted, disabled, restricted, or unsupported profiles may be skipped. - The Actor does not collect private analytics, audience demographics, email addresses, login-only data, or full content feeds. ### Responsible use Use the Actor only for lawful collection and processing of public information. Follow SocialBlade and source-platform terms, privacy and marketing law, intellectual-property requirements, and your organization's compliance policies. Do not use the output for harassment, sensitive profiling, stalking, spam, identity resolution, or automated outreach without a lawful basis. Public profile links and descriptions do not establish consent to commercial contact. SocialBlade, YouTube, TikTok, Instagram, and Twitch are trademarks of their respective owners. This independent Actor is not affiliated with or endorsed by those services. ### Frequently asked questions #### Does it require a SocialBlade account? No. It reads structured data from publicly accessible profile pages. #### Which platforms are supported? YouTube, TikTok, Instagram, and Twitch profile URLs are supported in the current version. #### Why are some fields empty? Each platform exposes different metrics. The Actor returns only values present in SocialBlade's public profile state. #### Does it include history? Yes, when SocialBlade exposes it. The normalized `history` array can contain up to 15 daily records. #### Can I submit a creator username instead of a URL? Use a full SocialBlade URL. This avoids ambiguous aliases and makes the requested platform explicit. #### Can I export to Excel? Yes. Open the default dataset and choose Excel, CSV, JSON, XML, RSS, or another Apify export format. ### You might also like - [Twitch Channel Scraper](https://apify.com/benthepythondev/twitch-channel-scraper) for current Twitch live state, games, social links, and videos. - [Pinterest Profile Scraper](https://apify.com/benthepythondev/pinterest-profile-scraper) for current public Pinterest profile metrics. - [TikTok Profile Scraper](https://apify.com/benthepythondev/tiktok-profile-scraper) for direct public TikTok profile data. - [YouTube Channel Intelligence](https://apify.com/benthepythondev/youtube-channel-intelligence) for YouTube channel-level research. ### Support and reviews If a current public SocialBlade URL fails, open an issue on the Actor page with the run ID, a redacted input, and the expected behavior. Reproducible reports are prioritized. If the Actor saves you time, please leave an honest Apify Store review. Reviews help other users compare tools and guide maintenance priorities. **Keywords:** SocialBlade scraper, Social Blade API, creator analytics, YouTube statistics scraper, TikTok follower history, Instagram engagement data, Twitch follower scraper, creator ranks, influencer research, social media monitoring, public creator dataset. # Actor input Schema ## `profileUrls` (type: `array`): Public SocialBlade YouTube, TikTok, Instagram, or Twitch profile URLs. ## `maxProfiles` (type: `integer`): Maximum number of supplied SocialBlade profiles processed in one run. ## Actor input object example ```json { "profileUrls": [ { "url": "https://socialblade.com/youtube/handle/mkbhd" }, { "url": "https://socialblade.com/tiktok/user/khaby.lame" }, { "url": "https://socialblade.com/instagram/user/cristiano" }, { "url": "https://socialblade.com/twitch/user/shroud" } ], "maxProfiles": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "profileUrls": [ { "url": "https://socialblade.com/youtube/handle/mkbhd" }, { "url": "https://socialblade.com/tiktok/user/khaby.lame" }, { "url": "https://socialblade.com/instagram/user/cristiano" }, { "url": "https://socialblade.com/twitch/user/shroud" } ], "maxProfiles": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("benthepythondev/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 = { "profileUrls": [ { "url": "https://socialblade.com/youtube/handle/mkbhd" }, { "url": "https://socialblade.com/tiktok/user/khaby.lame" }, { "url": "https://socialblade.com/instagram/user/cristiano" }, { "url": "https://socialblade.com/twitch/user/shroud" }, ], "maxProfiles": 10, } # Run the Actor and wait for it to finish run = client.actor("benthepythondev/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 '{ "profileUrls": [ { "url": "https://socialblade.com/youtube/handle/mkbhd" }, { "url": "https://socialblade.com/tiktok/user/khaby.lame" }, { "url": "https://socialblade.com/instagram/user/cristiano" }, { "url": "https://socialblade.com/twitch/user/shroud" } ], "maxProfiles": 10 }' | apify call benthepythondev/socialblade-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=benthepythondev/socialblade-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SocialBlade Scraper - Creator Stats and History", "description": "Scrape public SocialBlade profiles for YouTube, TikTok, Instagram and Twitch with audience counts, grades, ranks, profile data and 15-day histories.", "version": "1.0", "x-build-id": "QZYTMzzbSoijwgvMz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~socialblade-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-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/benthepythondev~socialblade-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-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/benthepythondev~socialblade-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-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", "properties": { "profileUrls": { "title": "SocialBlade profile URLs", "type": "array", "description": "Public SocialBlade YouTube, TikTok, Instagram, or Twitch profile URLs.", "default": [ { "url": "https://socialblade.com/youtube/handle/mkbhd" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxProfiles": { "title": "Maximum profiles", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of supplied SocialBlade profiles processed in one run.", "default": 10 } } }, "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 } } } } } } } } } } ```