# Social Blade Scraper (`radeance/socialblade-api`) Actor
Instantly access creator stats like estimated earnings, Top 100 rankings, subscriber growth, likes and views from YouTube, Instagram, TikTok, Twitch & Facebook at scale from SocialBlade.com. Export your data in JSON, CSV, Excel, and more for reporting, analysis, or automation.
- **URL**: https://apify.com/radeance/socialblade-api.md
- **Developed by:** [Radeance](https://apify.com/radeance) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 328 total users, 28 monthly users, 100.0% runs succeeded, 20 bookmarks
- **User rating**: 4.58 out of 5 stars
## Pricing
$19.99/month + usage
To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors
## 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
## π Social Blade Scraper
The **Social Blade Scraper** on **Apify** is a fast, reliable tool designed to extract **comprehensive creator analytics** from Social Blade β the leading platform for influencer performance insights.
It captures **detailed channel statistics**, **growth trends**, **earnings estimates**, and **ranking data** across major platforms like **YouTube** and **TikTok**. Get complete visibility into subscriber counts, video uploads, audience engagement, and projected channel growth accross Facebook, Instagram, Twitch and Youtube, all in one structured dataset.
Whether you're an **influencer marketer**, **brand strategist**, **data analyst**, or **creator**, this scraper provides **real-time Social Blade data** with export-ready results (**JSON**, **CSV**, **XLSX**, and more). Perfect for tracking growth, benchmarking competitors, and building creator analytics dashboards.
### βΆ Key Features
**- Comprehensive Creator Analytics** β
- Scrapes creators by platform and unique handle or ID (**YouTube, TikTok, Instagram, Twitch, Facebook**)
- Retrieves detailed performance data: **subscribers/followers**, uploads, views, daily/weekly/monthly growth
- Fetches **Social Blade rankings**, **estimated earnings** and **projections**
**- Top 100 Rankings Support** β
- Scrapes **Top 100 or Bottom 100** rankings for any supported platform
- Filter by **country, category**, and content type (YouTube only)
- Rank by various metrics: Social Blade rank, subscribers/followers, views, likes, videos/posts
**- Estimated Earnings Insights** β
- Extracts average estimated earnings for **daily, weekly, monthly, quarterly and yearly** windows
- Extracts daily estimated earnings up to the **last 14 days**
**- Time-Series Growth Insights** β
- Extracts subscriber and follower change data across **3, 7, 14, 30, 60, and 90-day** windows
- Provides a structured overview of audience growth over time
- Perfect for identifying **trends and momentum shifts**
**- Multi-Platform Social Footprint** β
- Gathers all linked social media accounts from the creator's profile
- Centralizes social presence across platforms into one **unified JSON output**
**- High-Speed, Scalable Scraping** β
- Supports **bulk scraping** of multiple creators in one run
- Built with **concurrency and smart retries** for reliable, high-speed performance
**- Flexible Output Formats** β
- Outputs clean, structured data in **JSON, CSV, XLSX, and JSONL** formats
- Ready for dashboards, BI tools, influencer databases, or automated workflows
### β· Output
#### Table View
#### JSON View
```json
{
"data_captured_at": "2025-07-03T11:22:14.263514",
"creator_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"creator_handle": "mrbeast",
"display_name": "MrBeast",
"platform": "youtube",
"created_at": "2012-02-20T00:00:00.000Z",
"verified": null,
"avatar": "https://yt3.ggpht.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s88-c-k-c0x00ffffff-no-rj",
"banner": "https://yt3.googleusercontent.com/5KWiriZZ_KEoEdSMFTJKj2M6vR_XSiRZeQ-ix0cvG3TGZuGoi8sfAjrSiZAP0GzXBkmF8ZGytw=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
"country": "US",
"category": "entertainment",
"made_for_kids": false,
"sb_grade": "A+",
"socials": [
"https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
"https://instagram.com/mrbeast",
"https://twitter.com/MrBeast"
],
"subscribers": 410000000,
"views": 88636856333,
"videos": 881,
"ranks": {
"metadata": {
"country": "US",
"category": "entertainment"
},
"position": {
"sb": 13,
"subscribers": 1,
"views": 12,
"country": 1,
"category": 1
},
"shared": {
"subscribers": 0,
"views": 0,
"country": 0,
"category": 0,
"sb": 2
},
"ahead": {
"subscribers": 0,
"views": 11,
"country": 0,
"category": 0,
"sb": 36
}
},
"subscribers_last_3d": "0",
"subscribers_last_7d": "2000000",
"subscribers_last_14d": "4000000",
"subscribers_last_30d": "10000000",
"subscribers_last_60d": "20000000",
"subscribers_last_90d": "29000000",
"subscribers_last_180d": "69000000",
"subscribers_last_365d": "115000000",
"views_last_3d": "308752575",
"views_last_7d": "965791737",
"views_last_14d": "1864118955",
"views_last_30d": "3672793226",
"views_last_60d": "6923687202",
"views_last_90d": "11001444766",
"views_last_180d": "19799809098",
"views_last_365d": "34946781772",
"videos_last_3d": "1",
"videos_last_7d": "1",
"videos_last_14d": "4",
"videos_last_30d": "6",
"videos_last_60d": "14",
"videos_last_90d": "23",
"videos_last_180d": "36",
"videos_last_365d": "36",
"estimated_earnings": {
"daily": {
"min": 30606.61,
"max": 489705.76,
"currency": "USD",
"formatted": "$30.6K - $489.7K"
},
"weekly": {
"min": 241447.93,
"max": 3863166.95,
"currency": "USD",
"formatted": "$241.4K - $3.9M"
},
"monthly": {
"min": 918198.31,
"max": 14691172.9,
"currency": "USD",
"formatted": "$918.2K - $14.7M"
},
"quarterly": {
"min": 2750361.19,
"max": 44005779.06,
"currency": "USD",
"formatted": "$2.8M - $44.0M"
},
"half_yearly": {
"min": 4949952.27,
"max": 79199236.39,
"currency": "USD",
"formatted": "$4.9M - $79.2M"
},
"yearly": {
"min": 8736695.44,
"max": 139787127.09,
"currency": "USD",
"formatted": "$8.7M - $139.8M"
}
},
"estimated_earnings_daily": [
{
"date": "2025-06-20 00:00:00",
"min": 28000,
"max": 455000,
"amount": "$28K - $455K"
},
{
"date": "2025-06-21 00:00:00",
"min": 25000,
"max": 404000,
"amount": "$25K - $404K"
},
{
"date": "2025-06-22 00:00:00",
"min": 49000,
"max": 787000,
"amount": "$49K - $787K"
},
...
],
"daily_growth": [
{
"date": "2025-06-19T00:00:00.000Z",
"subscribers": 406000000,
"views": "86614249353",
"videos": 878
},
{
"date": "2025-06-20T00:00:00.000Z",
"subscribers": 406000000,
"views": "86728063255",
"videos": 878
},
{
"date": "2025-06-21T00:00:00.000Z",
"subscribers": 406000000,
"views": "86828984559",
"videos": 879
},
...
],
"weekly_growth": [
{
"date": "2024-07-15T00:00:00.000Z",
"subscribers": 4000000,
"views": "564097844",
"videos": 0
},
{
"date": "2024-07-22T00:00:00.000Z",
"subscribers": 2000000,
"views": "644255943",
"videos": 0
},
{
"date": "2024-07-29T00:00:00.000Z",
"subscribers": 2000000,
"views": "693152608",
"videos": 0
},
...
],
"monthly_growth": [
{
"date": "2022-07-31T00:00:00.000Z",
"subscribers": 0,
"views": 0,
"videos": 0
},
{
"date": "2022-07-31T00:00:00.000Z",
"subscribers": 0,
"views": 0,
"videos": 0
},
{
"date": "2022-08-31T00:00:00.000Z",
"subscribers": 3000000,
"views": 521180192,
"videos": 0
},
...
],
"projections": [
{
"date": "2025-07-04 00:00:00+00:00",
"subscribers": 410300135,
"views": 87413198908.25
},
{
"date": "2025-07-05 00:00:00+00:00",
"subscribers": 410641978.85,
"views": 87521037336.35
},
{
"date": "2025-07-06 00:00:00+00:00",
"subscribers": 410983829.46,
"views": 87628950615.51
},
{
"date": "2025-07-07 00:00:00+00:00",
"subscribers": 411325686.83,
"views": 87736938745.73
},
...
],
"ranks_max": {
"subscribers": 5032,
"views": 5090393,
"sb": 1230019,
"countries": [
["NONE", 5],
["US", 4773],
["CA", 4343],
...
],
"categories": [
["games", 4522],
["entertainment", 4808],
["people", 4591],
["animals", 3734],
["film", 4359],
["music", 4618],
["sports", 4061],
["tech", 4008],
["howto", 4275],
["news", 4212],
["education", 4367],
["comedy", 4326],
["nonprofit", 3450],
["autos", 3794],
["travel", 3728],
["shows", 171]
]
}
}
````
### βΈ Input
**- `creators`: (Optional) (Array of Strings)**
List of creators to scrape data for by their usernames, channel IDs, channel URLs, or Social Blade URLs. You can input various formats such as usernames (e.g., "mrbeast"), YouTube channel URLs (e.g., "https://www.youtube.com/@PewDiePie"), or direct Social Blade URLs (e.g., "https://socialblade.com/youtube/handle/ninja").
**- `platform`: (Required) (String)**
The platform to scrape creator data from OR search across social media platforms OR the type of rankings to scrape. When set to rankings, the creators list will be automatically ignored. Available options include All (Cross Social Media Search), YouTube, TikTok, Instagram, Twitch, and Facebook, each with their respective Top 100 rankings options.
π‘ Default value is "youtube".
**- `exclude_platforms`: (Optional) (Array of String)**
Exclude specific platforms from the scraping process. This allows you to focus on desired platforms only when performing cross social media searches. For example, you can exclude Facebook, Twitch and Instagram if you only want YouTube, TikTok data.
**- `earnings`: (Optional) (Boolean)**
Include earnings data for creators in the scraped results. When enabled, the scraper will attempt to gather revenue and monetization information where available.
π‘ Default value is True.
**- `projections`: (Optional) (Boolean)**
Include projections data for creators showing future growth estimates and trend forecasts based on historical performance data.
π‘ Default value is True.
#### Supported URL Formats
| URL format | Supported |
| ---------------------------------------------------- | --------- |
| `https://www.youtube.com/@username` | β
|
| `https://www.youtube.com/channel/UCxxxxxxxx` | β
|
| `https://www.youtube.com/c/channelname` | β
|
| `https://www.youtube.com/user/username` | β
|
| `https://www.tiktok.com/@username` | β
|
| `https://www.instagram.com/username` | β
|
| `https://www.facebook.com/username` | β
|
| `https://www.twitch.tv/username` | β
|
| `https://socialblade.com/tiktok/user/username` | β
|
| `https://socialblade.com/youtube/channel/UCxxxxxxxx` | β
|
| `https://socialblade.com/youtube/handle/username` | β
|
| `https://socialblade.com/instagram/user/username` | β
|
| `https://socialblade.com/facebook/user/username` | β
|
| `https://socialblade.com/twitch/user/username` | β
|
| `username123` | β
|
#### Top 100 Ranking Filters
**- `rank_type`: (Optional) (String)**
The type of rank to scrape when using rankings mode. Choose "top" for the Top 100 performers or "bottom" for the Bottom 100 performers on the platform.
π‘ Default value is "top".
**- `rank_by`: (Optional) (String)**
The field to rank creators by. Options include Social Blade Rank, Subscribers/Followers, Views, Likes, Videos/Posts, and platform-specific metrics like "Talking About" for Facebook.
π‘ Default value is "sb" (Social Blade Rank).
**- `rank_category`: (Optional) (String)**
The category to filter by for YouTube rankings only. Available categories include Games, Entertainment, People & Blogs, Animals & Pets, Film & Animation, Music, Sports, Technology, News & Politics, Education, Comedy, and more.
π‘ Default value is "all".
**- `rank_country`: (Optional) (String)**
The country to filter by for YouTube rankings only. Choose from a comprehensive list of countries or select "global" for worldwide rankings. This helps you focus on creators from specific geographical regions.
π‘ Default value is "global".
**- `rank_filter`: (Optional) (String)**
The rank filter to apply for YouTube rankings only. Options include showing everyone, hiding channels made for kids, or showing only channels made for kids content.
π‘ Default value is "all" (Show Everyone).
#### JSON Input
Sample JSON input if you use the apify api via CURL, Python, JS etc.
```json
{
"creators": [
"mrbeast",
"https://www.youtube.com/@PewDiePie",
"https://socialblade.com/youtube/handle/ninja"
],
"earnings": true,
"projections": true
}
```
### βΉ Use Cases
- **Marketers & Agencies:** Monitor influencer growth across platforms, compare creators by performance, and identify rising stars for collaborations.
- **Influencer Managers:** Quickly pull detailed stats to evaluate creator reach, engagement history, and cross-platform presence for talent scouting and reporting.
- **Data Scientists & Analysts:** Access clean, structured creator data to model audience growth, detect virality trends, or run predictive analytics.
- **Content Creators & Streamers:** Track your own channel performance, benchmark against competitors, and fine-tune your content strategy based on real growth metrics.
- **Academics & Researchers:** Study digital influence, platform dynamics, and the evolution of creator economies using longitudinal, quantitative Social Blade data.
### βΊ Usage Limits
This service has different usage limits depending on your subscription status:
| User Type | Monthly Runs | Creators per Run | Earnings & Projections Data | Reset Period |
| --------- | -------------------------- | ---------------- | --------------------------- | ------------ |
| **Free** | 30 runs (3 with full data) | Max 3 creators | Limited to 3 runs per month | 30 days |
| **Paid** | Unlimited | Unlimited | Unlimited access | N/A |
#### How Limits Work
- **Free users**: Limited to 30 total runs per 30-day period, with only 3 runs including full estimated earnings and projections data
- **After 3 runs**: Earnings and projections data will be limited to 3 days of daily earnings & 30 days of projections data
- **Creator limit**: Free users can scrape maximum 3 creators per run; paid users have no limit
- **Paid users**: No limits on the number of runs, creators per run, or access to earnings/projections data
- **All users**: Can scrape multiple creators or access Top 100 rankings in a single run
- Usage resets automatically 30 days after your first run (for free users)
### β» FAQ
#### How do i make a basic search for a creator?
To make a basic search for a creator, simply input their username, channel ID, channel URL, or Social Blade URL into the `creators` field when running the scraper. For example, you can enter "mrbeast", "https://www.youtube.com/@PewDiePie", or "https://socialblade.com/youtube/handle/ninja" to search for those specific creators. The scraper will then extract the relevant data for the provided creator(s) based on the specified platform.
#### How do i get access to the paid version of the scraper?
To get access to the paid version of the scraper, just subscribe to any of the Apify paid plans. You can find more information about the plans and pricing on the [Apify Pricing Page](https://apify.com/pricing). Then you are able to rent our scraper for the monthly subscription fee displayed.
#### How do i use the scraper via API?
You can use the scraper via API by sending a POST request to the Apify API endpoint for this actor with your desired input parameters. You can find the API documentation and examples on how to do this in various programming languages in the [Apify API Documentation](https://docs.apify.com/api/v2/). Make sure to include your API token in the request headers for authentication.
### βΌ While the scraper is running
During the run, the actor will output log messages letting you know what is going on at any point. Each message always contains specific information about the process including which url / page the actor is working on.
If you provide invalid inputs to the actor, it will immediately stop with a failure state and output log messages explaining what is wrong. If you are unsure what went wrong feel free to open up an issue in the issue tab.
### β½ Legality of web scraping
The **Social Blade Scraper** is designed to ethically extract **only publicly available data**, and it **does not** scrape private user data such as personal email addresses or personal identifiers.
Our services are ethical and **do not extract any private user data**. They only extract **what individuals or companies chose to share publicly**. We therefore believe that our services, when used for ethical purposes by our users, are safe to use. 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. For more information you can read this [blog post](https://blog.apify.com/is-web-scraping-legal/) on the legality of web scraping from Apify.
### βΎ Feedback and Support
**Your satisfaction** is **important** to us! Therefore we are constantly striving to enhance the performance of our Actors.
If you have any technical feedback or encounter any bugs with the **Social Blade Scraper**, please create an issue in the Actorβs Issues tab on the Apify Console.
You can also contact us directly for **general help** on **issues** or **integrations** at suppport@radeance.com.
For **custom projects**, **general suggestions** or **new use cases** feel free to reach out to us at business@radeance.com
# Actor input Schema
## `creators` (type: `array`):
List of creators to scrape data for by their usernames.
## `platform` (type: `string`):
The platform to scrape creator data from or scrape all across social media platforms. OR the type of rankings to scrape. Creators will be automatically ignored if this is set to a rankings type.
## `exclude_platforms` (type: `array`):
Exclude specific platforms when scraping across all social media platforms. Only applicable when the platform is set to `all`.
## `earnings` (type: `boolean`):
Include earnings data for creators. Default is true.
## `projections` (type: `boolean`):
Include projections data for creators. Default is false.
## `rank_type` (type: `string`):
The type of rank to scrape.
## `rank_by` (type: `string`):
The field to rank by.
## `rank_category` (type: `string`):
The category to filter by. Only applicable for Top 100 Rankings of Youtube.
## `rank_country` (type: `string`):
The country to filter by. Only applicable for Top 100 Rankings of Youtube.
## `rank_filter` (type: `string`):
The rank filter to apply. Only applicable for Top 100 Rankings.
## Actor input object example
```json
{
"creators": [
"mrbeast",
"https://www.youtube.com/@PewDiePie",
"https://socialblade.com/youtube/handle/ninja"
],
"platform": "youtube",
"earnings": true,
"projections": true,
"rank_type": "top",
"rank_by": "sb",
"rank_category": "all",
"rank_country": "global",
"rank_filter": "all"
}
```
# 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 = {
"creators": [
"mrbeast",
"https://www.youtube.com/@PewDiePie",
"https://socialblade.com/youtube/handle/ninja"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("radeance/socialblade-api").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 = { "creators": [
"mrbeast",
"https://www.youtube.com/@PewDiePie",
"https://socialblade.com/youtube/handle/ninja",
] }
# Run the Actor and wait for it to finish
run = client.actor("radeance/socialblade-api").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 '{
"creators": [
"mrbeast",
"https://www.youtube.com/@PewDiePie",
"https://socialblade.com/youtube/handle/ninja"
]
}' |
apify call radeance/socialblade-api --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=radeance/socialblade-api",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Social Blade Scraper",
"description": "Instantly access creator stats like estimated earnings, Top 100 rankings, subscriber growth, likes and views from YouTube, Instagram, TikTok, Twitch & Facebook at scale from SocialBlade.com. Export your data in JSON, CSV, Excel, and more for reporting, analysis, or automation.",
"version": "0.0",
"x-build-id": "qRYok3XrlpXoSpOCQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/radeance~socialblade-api/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-radeance-socialblade-api",
"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/radeance~socialblade-api/runs": {
"post": {
"operationId": "runs-sync-radeance-socialblade-api",
"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/radeance~socialblade-api/run-sync": {
"post": {
"operationId": "run-sync-radeance-socialblade-api",
"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": {
"creators": {
"title": "Creators by Username, Channel ID, Channel URL or Social Blade URL",
"type": "array",
"description": "List of creators to scrape data for by their usernames.",
"items": {
"type": "string"
}
},
"platform": {
"title": "Platform / Rankings",
"enum": [
"all",
"youtube",
"youtube_rankings",
"tiktok",
"tiktok_rankings",
"instagram",
"instagram_rankings",
"twitch",
"twitch_rankings",
"facebook",
"facebook_rankings"
],
"type": "string",
"description": "The platform to scrape creator data from or scrape all across social media platforms. OR the type of rankings to scrape. Creators will be automatically ignored if this is set to a rankings type.",
"default": "youtube"
},
"exclude_platforms": {
"title": "Exclude Platforms (Cross Social Media Search Only)",
"uniqueItems": true,
"type": "array",
"description": "Exclude specific platforms when scraping across all social media platforms. Only applicable when the platform is set to `all`.",
"items": {
"type": "string",
"enum": [
"youtube",
"tiktok",
"instagram",
"twitch",
"facebook"
],
"enumTitles": [
"YouTube",
"TikTok",
"Instagram",
"Twitch",
"Facebook"
]
}
},
"earnings": {
"title": "Include earnings",
"type": "boolean",
"description": "Include earnings data for creators. Default is true.",
"default": true
},
"projections": {
"title": "Include projections",
"type": "boolean",
"description": "Include projections data for creators. Default is false.",
"default": true
},
"rank_type": {
"title": "Rank Type",
"enum": [
"top",
"bottom"
],
"type": "string",
"description": "The type of rank to scrape.",
"default": "top"
},
"rank_by": {
"title": "Rank By",
"enum": [
"sb",
"subscribers",
"followers",
"views",
"likes",
"videos",
"posts",
"talking_about"
],
"type": "string",
"description": "The field to rank by.",
"default": "sb"
},
"rank_category": {
"title": "Category (Youtube Only)",
"enum": [
"all",
"games",
"entertainment",
"people",
"animals",
"film",
"music",
"sports",
"tech",
"howto",
"news",
"education",
"comedy",
"nonprofit",
"autos",
"travel"
],
"type": "string",
"description": "The category to filter by. Only applicable for Top 100 Rankings of Youtube.",
"default": "all"
},
"rank_country": {
"title": "Country (Youtube Only)",
"enum": [
"global",
"af",
"al",
"dz",
"as",
"ad",
"ao",
"ai",
"ag",
"ar",
"am",
"au",
"at",
"az",
"bs",
"bh",
"bd",
"by",
"be",
"bz",
"bj",
"bt",
"bo",
"ba",
"bw",
"br",
"bn",
"bg",
"bf",
"bi",
"kh",
"cm",
"ca",
"cv",
"cf",
"td",
"cl",
"co",
"cg",
"cd",
"ck",
"cr",
"ci",
"hr",
"cy",
"cz",
"dk",
"dj",
"dm",
"do",
"ec",
"eg",
"sv",
"ee",
"et",
"fj",
"fi",
"fr",
"ga",
"gm",
"ge",
"de",
"gh",
"gi",
"gr",
"gl",
"gp",
"gt",
"gg",
"gy",
"ht",
"hn",
"hk",
"hu",
"is",
"in",
"id",
"iq",
"ie",
"il",
"it",
"jm",
"jp",
"je",
"jo",
"kz",
"ke",
"ki",
"kr",
"kw",
"kg",
"la",
"lv",
"lb",
"ls",
"ly",
"li",
"lt",
"lu",
"mk",
"mg",
"mw",
"my",
"mv",
"ml",
"mt",
"mu",
"mx",
"fm",
"md",
"mn",
"me",
"ms",
"ma",
"mz",
"mm",
"na",
"nr",
"np",
"nl",
"nz",
"ni",
"ne",
"ng",
"nu",
"no",
"om",
"pk",
"ps",
"pa",
"pg",
"py",
"pe",
"ph",
"pn",
"pl",
"pt",
"pr",
"qa",
"ro",
"ru",
"rw",
"sh",
"vc",
"ws",
"sm",
"st",
"sa",
"sn",
"rs",
"sc",
"sl",
"sg",
"sk",
"si",
"sb",
"so",
"za",
"es",
"lk",
"sr",
"se",
"ch",
"tw",
"tj",
"tz",
"th",
"tl",
"tg",
"tk",
"to",
"tt",
"tn",
"tr",
"tm",
"ug",
"ua",
"ae",
"gb",
"us",
"uy",
"uz",
"vu",
"ve",
"vn",
"vg",
"vi",
"zm",
"zw"
],
"type": "string",
"description": "The country to filter by. Only applicable for Top 100 Rankings of Youtube.",
"default": "global"
},
"rank_filter": {
"title": "Rank Filter (Youtube Only)",
"enum": [
"all",
"hide_made_for_kids",
"only_made_for_kids"
],
"type": "string",
"description": "The rank filter to apply. Only applicable for Top 100 Rankings.",
"default": "all"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```