{ "openapi": "3.0.1", "info": { "title": "Social Blade Scraper", "description": "Read public Social Blade profile analytics or one ranking query across YouTube, TikTok, Twitch, Instagram, and Facebook. Get structured rows with creator context, audience and content metrics, ranks, history, growth, earnings ranges, or ranking positions when Social Blade exposes them.", "version": "0.0", "x-build-id": "feu9tUa7r9KioLVv2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~socialblade/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-socialblade", "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/maximedupre~socialblade/runs": { "post": { "operationId": "runs-sync-maximedupre-socialblade", "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/maximedupre~socialblade/run-sync": { "post": { "operationId": "run-sync-maximedupre-socialblade", "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", "required": [ "resultType" ], "properties": { "resultType": { "title": "Result type", "enum": [ "profiles", "ranking" ], "type": "string", "description": "Choose the kind of result to return. Profile analytics reads submitted profiles. Ranking results runs one Social Blade ranking query." }, "profileTargets": { "title": "Profile URLs or handles", "type": "array", "description": "Enter one or more full Social Blade profile URLs or raw handles. URLs can use different platforms in one run. A raw handle uses the platform below.", "items": { "type": "string", "minLength": 1 } }, "handlePlatform": { "title": "Platform for raw handles", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "type": "string", "description": "Choose the platform for raw handles in the list. Full URLs keep their own platform. This field is used only for Profile analytics." }, "rankingPlatform": { "title": "Ranking platform", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "type": "string", "description": "Choose the platform for the ranking query. The result contains ranked creators from this platform." }, "rankingMetric": { "title": "Ranking metric", "minLength": 1, "type": "string", "description": "Enter the Social Blade metric used to rank creators, such as subscribers, followers, views, or uploads." }, "rankingDirection": { "title": "Ranking direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Choose whether the highest or lowest metric values appear first.", "default": "desc" }, "rankingCountry": { "title": "Country filter", "minLength": 1, "type": "string", "description": "Optionally enter a country supported by the selected Social Blade ranking. Leave this empty for all countries." }, "rankingCategory": { "title": "Category filter", "minLength": 1, "type": "string", "description": "Optionally enter a category supported by the selected Social Blade ranking. Leave this empty for all categories." }, "rankingContentType": { "title": "Content filter", "minLength": 1, "type": "string", "description": "Optionally enter a content filter supported by the selected platform and ranking. Leave this empty for all content." } } }, "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 } } } } } } } } } }