Social Blade scraper with Python, JavaScript and cURL

Run Social Blade Multi-Platform Analytics Scraper from Apify's web interface without writing code, or integrate it with Python, JavaScript or cURL to get structured creator profile and history data.

This repository contains working request examples, sample input, sample output and CSV data so you can inspect the result format before running a live request.

Open Social Blade Multi-Platform Analytics Scraper on Apify

What this repository helps you do

• Collect public Social Blade profiles across YouTube, TikTok, Twitch, Instagram and Facebook.
• Compare audience, content, engagement, growth, ranking and earnings signals in a normalized Dataset.
• Keep available daily, weekly and monthly history alongside the current profile snapshot.
• Export or process creator analytics as JSON, CSV, Excel or JSONL in your own workflow.

The hosted Actor accepts Social Blade URLs or bare handles. It resolves each profile, keeps duplicate and failed inputs auditable, and reports source coverage instead of inventing unavailable metrics.

Example result

The repository includes a sanitized example in data/sample-output.json and a tabular version in data/sample-output.csv.

{
  "recordType": "profile",
  "status": "ok",
  "platform": "youtube",
  "creatorId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "username": "mrbeast",
  "primaryAudience": 516000000,
  "primaryAudienceMetric": "subscribers",
  "mediaCount": 1000,
  "growthWindows": {
    "subscribers": {
      "days30": { "delta": 4000000, "pct": 0.78125 }
    }
  },
  "dataQuality": {
    "availableEndpoints": ["growth", "history", "monthly", "ranksGet", "ranksMax", "summary", "user"],
    "unavailableEndpoints": []
  }
}

Run without code

You can run the hosted Actor directly from the Apify web interface. This is the simplest option if you do not need to write a program.

1. Open Social Blade Multi-Platform Analytics Scraper on Apify.
2. In the Input tab, add public Social Blade URLs or handles under profiles.
3. Review the optional history and metric settings, then click Start.
4. Open the Dataset tab to inspect profile and history records.
5. Export the Dataset as JSON, CSV, Excel or JSONL when you need a file for a spreadsheet or another tool.

Use docs/no-code-guide.md for the field-by-field walkthrough and data/sample-input.json for a first test input.

Try it with Apify's free plan

Apify's Free plan includes $5 in monthly prepaid usage for the Apify Store or your own Actors, and no credit card is required to start. This can cover a small first test while credit is available; it is not unlimited free usage.

Unused credits expire at the end of the billing cycle and do not roll over. Check the current Apify pricing before running a larger batch.

Quick start for developers

Python

1. Install the client

pip install -r examples/python/requirements.txt

2. Set your Apify token

export APIFY_API_TOKEN="your-token"

On Windows PowerShell:

$env:APIFY_API_TOKEN = "your-token"

3. Run the example

python examples/python/socialblade_profile_scraper.py

The example reads data/sample-input.json, starts the hosted Actor and prints the returned Dataset items.

Input example

{
  "profiles": [
    "https://socialblade.com/youtube/handle/mrbeast"
  ]
}

profiles is required and accepts 1–1,000 Social Blade URLs or bare handles. The other fields have safe defaults, so the smallest request is enough for a first run. See the complete field guide in docs/input-reference.md.

Request examples

cURL

See examples/curl-request.md for the synchronous API request.

Python

See examples/python/socialblade_profile_scraper.py, examples/python/batch_socialblade_profiles.py and examples/python/export_socialblade_csv.py.

JavaScript

See examples/javascript/request.mjs.

All examples use the hosted Apify Actor. They do not require the Actor source code locally or any separate access credentials for the underlying public source.

Output fields

The most useful fields are:

Field	Meaning
recordType and status	Identify profile, daily, weekly or monthly records and whether the result is ok, partial or an error.
primaryAudience	The main subscriber, follower or audience count for the platform.
audience and content	Normalized audience totals and media counts, with platform-specific values preserved where available.
growthWindows	Metric-first deltas and percentages for available time windows.
rankings	Current and maximum public ranking signals.
dataQuality	Available, missing, failed, unavailable and not-requested endpoint coverage.
requestMetrics	Per-profile timing, request counts and HTTP status information.

See docs/output-reference.md for the complete output contract.

Common use cases

Read docs/use-cases.md for complete examples covering:

• Creator and influencer research.
• Cross-platform competitor comparisons.
• Historical reporting and recurring snapshots.
• Sponsorship and talent discovery workflows.

How to scrape Social Blade profiles with Python

Use socialblade_profile_scraper.py for the checked-in request or batch_socialblade_profiles.py when you need to process multiple profiles. The batch example accepts repeated --profile arguments and leaves each input's status visible in the returned Dataset.

Export Social Blade profile data to CSV

Apify can export the Dataset directly. For a saved JSON Dataset response, run export_socialblade_csv.py to create a flattened CSV containing profile identity, audience, content, status, ranks and timing fields.

FAQ

See docs/faq.md for questions derived from the actual Actor inputs, output records, billing and platform coverage.

Limits and pricing

The run accepts up to 1,000 submitted profiles and requests up to 31 daily history rows per profile. One billable unit is one successfully delivered profile snapshot (recordType: profile, status: ok). Invalid, duplicate, failed, partial and skipped records do not create that charge, and history rows are included in the profile snapshot charge.

Apify tier	Price per profile snapshot	Equivalent per 1,000 profile snapshots
FREE	$0.00500	$5.00
BRONZE	$0.00450	$4.50
SILVER	$0.00400	$4.00
GOLD	$0.00375	$3.75
PLATINUM	$0.00375	$3.75
DIAMOND	$0.00375	$3.75

The 1,000-profile values are comparison equivalents; billing remains per profile snapshot. Apify resolves the applicable tier price on the Actor page.

Hosted version

Use the hosted version when you need repeatable execution, batching, scheduling, API access or Dataset storage without managing the collection infrastructure yourself:

Open Social Blade Multi-Platform Analytics Scraper on Apify

Responsible use

Use only publicly accessible information for a lawful purpose. Respect Social Blade's terms, the terms of the underlying platforms, privacy and data-protection obligations, intellectual-property rights and applicable retention requirements. Do not use the data for spam, harassment, credential collection, discrimination or unlawful profiling.

Never commit API tokens, cookies or other credentials to this repository.

Support

For a problem with the examples, open a GitHub issue with the command, sanitized input and error message. For an execution problem, include the Apify run ID but never include your token.

License

This repository is released under the MIT License.