{ "openapi": "3.0.1", "info": { "title": "Social Blade Scraper API - YouTube, TikTok, Twitch Stats", "description": "YouTube shows today's count. Social Blade kept the daily record. JSON for YouTube, TikTok, Twitch, Instagram, Facebook: subscribers, followers, views, likes, grade, ranks, 3-365 day growth, daily history, top-100 leaderboards and its earnings estimate. $1.00 per 1,000 profiles.", "version": "0.1", "x-build-id": "Qc5w4RmtKre3xFjhv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~socialblade-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~socialblade-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~socialblade-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "profiles": { "title": "Profiles", "type": "array", "description": "Social Blade profile URLs, or \"platform:identifier\" entries. Examples: https://socialblade.com/youtube/channel/UCX6OQ3DkcsbYNE6H8uQQuVA, youtube:@MrBeast, tiktok:khaby.lame, twitch:xqc, instagram:cristiano, facebook:Cristiano. A bare handle uses the Platform field below.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Creator names to search on Social Blade. Each query returns up to \"Results per query\" profiles on the selected platform.", "items": { "type": "string" } }, "topLists": { "title": "Top lists (leaderboards)", "type": "array", "description": "Social Blade leaderboards. Format: \"platform\", \"platform/field\", \"platform/field/COUNTRY\" or \"platform/field/COUNTRY/category\". Fields: youtube = subscribers|views|videos, tiktok = followers|likes, twitch = followers, instagram = followers, facebook = likes|talking_about. COUNTRY and category are YouTube-only. Examples: youtube/subscribers, youtube/views/IN, youtube/subscribers/NONE/music, tiktok/followers, twitch/followers.", "items": { "type": "string" } }, "platform": { "title": "Default platform", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "type": "string", "description": "Used for bare handles in \"Profiles\" and for every entry in \"Search queries\".", "default": "youtube" }, "maxItems": { "title": "Max profiles", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on charged rows for the whole run.", "default": 100 }, "topListSize": { "title": "Creators per top list", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many creators to take from each leaderboard. Social Blade's free leaderboard tops out at 100 per list, so anything higher is capped at 100.", "default": 100 }, "resultsPerQuery": { "title": "Results per search query", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many matches to keep for each entry in \"Search queries\".", "default": 5 }, "includeGrowth": { "title": "Include growth (3-365 day deltas)", "type": "boolean", "description": "Adds subscriber/follower/view/like deltas over 3, 7, 14, 30, 60, 90, 180 and 365 days. YouTube earnings estimates are derived from this, so turning it off also removes them. Not available for Instagram (Social Blade puts Instagram growth behind its own paid plan).", "default": true }, "includeHistory": { "title": "Include daily history", "type": "boolean", "description": "Adds the day-by-day stat table. Social Blade serves the last 30 days to unauthenticated visitors. Not available for Instagram.", "default": false }, "historyDays": { "title": "History days", "minimum": 2, "maximum": 365, "type": "integer", "description": "How many days of daily history to request. Social Blade returns at most 30 for free.", "default": 30 }, "enrichTopLists": { "title": "Full profile for leaderboard rows", "type": "boolean", "description": "Leaderboard payloads omit Social Blade's grade and rank block. Leave this on to fetch the full profile for every creator on a top list. Turn it off for a faster, lighter run that keeps only the leaderboard fields.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. This actor reaches Social Blade directly and does not need a proxy; supply your own only if your account requires one.", "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 } } }, "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 } } } } } } } } } }