{ "openapi": "3.0.1", "info": { "title": "Social Blade Scraper — YouTube, TikTok, Instagram & Twitch", "description": "Free Social Blade scraper for YouTube, TikTok, Twitch, Instagram and Facebook. Get subscribers, followers, views, ranks, grades, daily history, growth and earnings estimates — look up creators or discover top creators by country and category. No login or API key.", "version": "0.1", "x-build-id": "cBKAsIje92Jjg90cL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/amrameng~socialblade-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-amrameng-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/amrameng~socialblade-scraper/runs": { "post": { "operationId": "runs-sync-amrameng-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/amrameng~socialblade-scraper/run-sync": { "post": { "operationId": "run-sync-amrameng-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", "required": [ "mode" ], "properties": { "mode": { "title": "What do you want to do?", "enum": [ "profiles", "rankings" ], "type": "string", "description": "Choose how the run finds creators. **Look up specific creators** = you paste handles/URLs. **Discover top creators** = we pull ranked leaderboards you filter by platform, country and category.", "default": "profiles" }, "profiles": { "title": "Creator handles or URLs", "type": "array", "description": "One creator per line. Accepts a full Social Blade URL (e.g. `https://socialblade.com/youtube/user/pewdiepie`), a platform handle (`@pewdiepie`, `ninja`, `cristiano`) or a YouTube channel ID (`UC-...`). YouTube handles are resolved to the channel automatically. Used in **Look up specific creators** mode.", "items": { "type": "string" } }, "defaultPlatform": { "title": "Default platform for bare handles", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "type": "string", "description": "If a line above is just a handle with no platform (e.g. `mrbeast`), which platform should we assume? Lines that are full Social Blade URLs ignore this.", "default": "youtube" }, "rankingPlatforms": { "title": "Platforms", "type": "array", "description": "Which platforms to pull leaderboards for. Pick one or several — we fetch a ranked list for each. Used in **Discover top creators** mode.", "items": { "type": "string", "enum": [ "youtube", "tiktok", "twitch", "instagram", "facebook" ], "enumTitles": [ "YouTube", "TikTok", "Twitch", "Instagram", "Facebook" ] }, "default": [ "youtube" ] }, "rankBy": { "title": "Rank by", "enum": [ "auto", "subscribers", "views", "videos", "followers", "likes", "posts", "talking_about" ], "type": "string", "description": "Metric to sort the leaderboard by. **Auto** uses each platform's primary metric (YouTube = subscribers, Twitch/Instagram/TikTok = followers, Facebook = likes). If you pick a metric a selected platform doesn't support, that platform falls back to Auto.", "default": "auto" }, "rankSort": { "title": "Order", "enum": [ "desc", "asc" ], "type": "string", "description": "Sort the leaderboard with the highest value first (top creators) or lowest first.", "default": "desc" }, "rankLimit": { "title": "How many per list", "enum": [ "10", "50", "100", "250", "500", "1000", "5000" ], "type": "string", "description": "Number of creators per leaderboard. Note: this multiplies — Top 100 with 2 platforms × 3 countries = up to 600 results.", "default": "100" }, "rankCountries": { "title": "Countries (YouTube only)", "type": "array", "description": "Filter the YouTube leaderboard by creator country. Leave as **Global** for worldwide. Pick several to pull a separate list per country. Ignored for non-YouTube platforms (Social Blade only offers country ranking on YouTube).", "items": { "type": "string", "enum": [ "global", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AC", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "IC", "CV", "BQ", "KY", "CF", "EA", "TD", "CL", "CN", "CX", "CP", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "TP", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GZ", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "WS", "SM", "ST", "SA", "SN", "RS", "CS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TA", "TN", "TR", "TM", "TC", "TV", "UM", "VI", "UG", "UA", "AE", "UK", "GB", "US", "XX", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZH", "ZW" ], "enumTitles": [ "🌍 Global (all countries)", "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua & Barbuda", "Argentina", "Armenia", "Aruba", "Ascension Island", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia & Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Canary Islands", "Cape Verde", "Caribbean Netherlands", "Cayman Islands", "Central African Republic", "Ceuta & Melilla", "Chad", "Chile", "China", "Christmas Island", "Clipperton Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo - Brazzaville", "Congo - Kinshasa", "Cook Islands", "Costa Rica", "Côte d’Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czechia", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Gaza Strip", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard & McDonald Islands", "Honduras", "Hong Kong SAR China", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao SAR China", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar (Burma)", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestinian Territories", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar", "Réunion", "Romania", "Russia", "Rwanda", "Samoa", "San Marino", "São Tomé & Príncipe", "Saudi Arabia", "Senegal", "Serbia", "Serbia & Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia & South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "St. Barthélemy", "St. Helena", "St. Kitts & Nevis", "St. Lucia", "St. Martin", "St. Pierre & Miquelon", "St. Vincent & Grenadines", "Sudan", "Suriname", "Svalbard & Jan Mayen", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad & Tobago", "Tristan da Cunha", "Tunisia", "Türkiye", "Turkmenistan", "Turks & Caicos Islands", "Tuvalu", "U.S. Outlying Islands", "U.S. Virgin Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United Kingdom", "United States", "Unknown", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis & Futuna", "Western Sahara", "Yemen", "Zambia", "ZH", "Zimbabwe" ] }, "default": [ "global" ] }, "rankCategories": { "title": "Categories (YouTube only)", "type": "array", "description": "Filter the YouTube leaderboard by content category. Leave as **All** for no filter. Pick several to pull a separate list per category. Ignored for non-YouTube platforms.", "items": { "type": "string", "enum": [ "all", "games", "entertainment", "people", "animals", "film", "music", "sports", "tech", "howto", "news", "education", "comedy", "nonprofit", "autos", "travel", "shows" ], "enumTitles": [ "All categories", "Games", "Entertainment", "People & Blogs", "Animals & Pets", "Film & Animation", "Music", "Sports", "Science & Tech", "Howto & Style", "News & Politics", "Education", "Comedy", "Nonprofit & Activism", "Autos & Vehicles", "Travel & Events", "Shows" ] }, "default": [ "all" ] }, "madeForKids": { "title": "Made-for-kids channels (YouTube only)", "enum": [ "all", "exclude", "only" ], "type": "string", "description": "YouTube only: include all channels, exclude “made for kids” channels, or return only “made for kids” channels.", "default": "all" }, "includeHistory": { "title": "Include daily history", "type": "boolean", "description": "Add a per-day time series (subscribers/followers, views, etc.) to every creator.", "default": true }, "historyDays": { "title": "Days of history", "minimum": 1, "maximum": 31, "type": "integer", "description": "How many days of daily history to return per creator. Social Blade caps anonymous history at **31 days**, so values above 31 return the maximum available.", "default": 31 }, "includeGrowth": { "title": "Include growth deltas", "type": "boolean", "description": "Add 1 / 7 / 14 / 30-day growth (absolute and %), computed from the daily history. Requires history.", "default": true }, "includeEarnings": { "title": "Include earnings estimates", "type": "boolean", "description": "Add estimated monthly/yearly earnings in USD for YouTube channels, derived from recent view growth and Social Blade’s CPM ranges (Social Blade does not return this directly — it is computed the same way the website does).", "default": true }, "maxResults": { "title": "Maximum results (safety cap)", "minimum": 1, "type": "integer", "description": "Hard cap on total creators written to the dataset across all platforms/countries/categories. Protects you from accidental large/expensive runs. Leave empty for no cap." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Social Blade is behind Cloudflare; a proxy with a browser-like fingerprint is required. Apify Proxy (datacenter) works by default; switch to residential if you see blocks.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }