{
"openapi": "3.0.1",
"info": {
"title": "SocialBlade Scraper",
"description": "Scrape SocialBlade stats for YouTube, TikTok, Instagram, Twitch and Facebook creators: subscribers, followers, views, grade, ranks, 30-day history and growth, plus top-100 rankings. Export JSON, CSV, Excel.",
"version": "1.0",
"x-build-id": "OFHBZrwJsEboio0yV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parsebird~socialblade-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parsebird-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/parsebird~socialblade-scraper/runs": {
"post": {
"operationId": "runs-sync-parsebird-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/parsebird~socialblade-scraper/run-sync": {
"post": {
"operationId": "run-sync-parsebird-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": {
"startUrls": {
"title": "SocialBlade URLs",
"type": "array",
"description": "Paste SocialBlade creator or ranking URLs, e.g. https://socialblade.com/youtube/handle/mrbeast, https://socialblade.com/youtube/channel/UCX6OQ3DkcsbYNE6H8uQQuVA, https://socialblade.com/tiktok/user/khaby.lame or https://socialblade.com/youtube/lists/top/100/subscribers/music/US. Mix platforms freely.",
"items": {
"type": "string"
}
},
"profiles": {
"title": "Usernames, handles or IDs",
"type": "array",
"description": "Enter creators without building a URL, one per line, e.g. mrbeast, @veritasium or a YouTube channel ID UC.... They are looked up on the Platform below. YouTube names are resolved as handles, the reliable form.",
"items": {
"type": "string"
}
},
"platform": {
"title": "Platform",
"enum": [
"youtube",
"tiktok",
"instagram",
"twitch",
"facebook"
],
"type": "string",
"description": "Platform for Usernames, handles or IDs and Search creators.",
"default": "youtube"
},
"searchQueries": {
"title": "Search creators",
"type": "array",
"description": "Find creators by name on the selected platform, e.g. cristiano. SocialBlade returns about 5 best matches per search.",
"items": {
"type": "string"
}
},
"rankingPlatform": {
"title": "Ranking platform",
"enum": [
"",
"youtube",
"tiktok",
"instagram",
"twitch",
"facebook"
],
"type": "string",
"description": "Pick a platform to add its SocialBlade top list (up to 100 creators). Leave empty to skip rankings.",
"default": ""
},
"rankingMetric": {
"title": "Rank by",
"enum": [
"",
"subscribers",
"views",
"videos",
"followers",
"likes",
"posts",
"talking_about"
],
"type": "string",
"description": "Metric to rank by. YouTube: subscribers, views, videos. TikTok: followers, likes. Instagram: followers, posts. Twitch: followers. Facebook: likes, talking about. Leave empty for the platform's main metric.",
"default": ""
},
"rankingCountry": {
"title": "Country (YouTube rankings)",
"pattern": "^([A-Za-z]{2})?$",
"type": "string",
"description": "Two-letter country code for YouTube rankings, e.g. US, IN, BR. Leave empty for global."
},
"rankingCategory": {
"title": "Category (YouTube rankings)",
"enum": [
"",
"games",
"entertainment",
"people",
"animals",
"film",
"music",
"sports",
"tech",
"howto",
"news",
"education",
"comedy",
"nonprofit",
"autos",
"travel",
"shows"
],
"type": "string",
"description": "YouTube category for the ranking. Leave empty for all categories.",
"default": ""
},
"rankingLimit": {
"title": "Ranking size",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "How many creators to take from the ranking (SocialBlade lists up to 100).",
"default": 100
},
"includeHistory": {
"title": "Include daily history",
"type": "boolean",
"description": "Add daily snapshots of the creator's stats (up to 30 days) and the change over that period. Billed as additional data only for creators that have it.",
"default": true
},
"historyDays": {
"title": "History days",
"minimum": 2,
"maximum": 30,
"type": "integer",
"description": "Number of daily snapshots to add (2 to 30).",
"default": 30
},
"includeGrowth": {
"title": "Include growth summary",
"type": "boolean",
"description": "Add SocialBlade's growth figures for the last 1, 3, 7, 14, 30, 60, 90, 180 and 365 days and year to date, per metric. Billed as additional data only for creators that have it.",
"default": true
},
"maxItems": {
"title": "Max creators",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum number of creators to save across all inputs.",
"default": 50
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "SocialBlade works without a proxy. Add one only if you need requests to come from a specific network.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}