{ "openapi": "3.0.1", "info": { "title": "Social Blade Scraper", "description": "[💰 $30.0 / 1K] Extract creator analytics from Social Blade across YouTube, TikTok, Twitch, Instagram, and Facebook — subscribers, views, ranks, grade, daily history, growth, and earnings estimates.", "version": "1.2", "x-build-id": "AGvODYDu1Ev1tOuJf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~socialblade-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~socialblade-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~socialblade-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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": "Creator Profiles", "type": "array", "description": "Social Blade profile URLs or raw handles. Examples:\n - https://socialblade.com/youtube/user/pewdiepie\n - https://socialblade.com/tiktok/user/charlidamelio\n - https://socialblade.com/twitch/user/ninja\n - https://socialblade.com/instagram/user/cristiano\n - https://socialblade.com/facebook/user/walmart\n - pewdiepie (raw handle — set the Default Platform below)", "items": { "type": "string" } }, "defaultPlatform": { "title": "Default Platform", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "type": "string", "description": "Used for any entry above that is a raw handle (not a full Social Blade URL). Ignored when the URL itself tells us the platform.", "default": "youtube" }, "includeDailyHistory": { "title": "Include Daily History", "type": "boolean", "description": "Add a separate row per profile per day of stats (subscribers/followers, views, uploads, likes, etc.). Social Blade exposes up to 31 days of history to anonymous visitors, so this adds at most ~31 extra rows per profile. Leave off if you only need the current snapshot.", "default": false }, "historyDays": { "title": "History Days Per Profile", "minimum": 1, "maximum": 31, "type": "integer", "description": "How many days of daily history to pull per profile when Include Daily History is on. Social Blade caps anonymous history at about 31 days, so values above 31 are silently clamped. Set lower to bound cost — e.g. 7 for last week only.", "default": 31 }, "includeGrowthMetrics": { "title": "Include Growth & Averages", "type": "boolean", "description": "Add computed averages and growth deltas (1/7/14/30-day) to each profile row. Computed from the daily history we already fetched — no extra requests, no extra rows.", "default": true }, "includeEarningsEstimates": { "title": "Include Earnings Estimates", "type": "boolean", "description": "Add Social Blade's daily / monthly / yearly earnings ranges (low–high USD) to each profile row, where Social Blade provides them. YouTube and TikTok have estimates; Twitch / Instagram / Facebook generally do not.", "default": true }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on total rows pushed across all profiles (counts profile rows plus any daily history rows). Use 0 for no cap. The actor stops processing more profiles once this number is reached but keeps the full final profile's rows even if it slightly overshoots.", "default": 0 } } }, "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 } } } } } } } } } }