{ "openapi": "3.0.1", "info": { "title": "Facebook Followers & Following Scraper", "description": "Facebook Followers & Following Scraper — Extract Facebook followers and following data, including names, profile URLs, usernames, and publicly available profile details. Useful for audience research, influencer analysis, lead generation, competitor monitoring, and social network insights.", "version": "0.1", "x-build-id": "OMwfEhuP1ZOEHAvJd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialdataapi~facebook-followers-following-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialdataapi-facebook-followers-following-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/socialdataapi~facebook-followers-following-scraper/runs": { "post": { "operationId": "runs-sync-socialdataapi-facebook-followers-following-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/socialdataapi~facebook-followers-following-scraper/run-sync": { "post": { "operationId": "run-sync-socialdataapi-facebook-followers-following-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": [ "startUrls", "fbCUserCookie", "fbXsCookie" ], "properties": { "startUrls": { "title": "🔗 Facebook profile URLs or usernames", "minItems": 1, "type": "array", "description": "List one or more Facebook profile URLs (e.g. https://www.facebook.com/mrbeast) or plain usernames (e.g. mrbeast). An entry that is not a URL or username is instead treated as a keyword filter applied to the results' name and subtitle text.", "items": { "type": "string" } }, "followType": { "title": "🔧 Follow list to scrape", "enum": [ "both", "followers", "following" ], "type": "string", "description": "Followers returns people who follow this profile. Following returns accounts this profile follows. Both splits the results limit evenly between followers and following for each profile.", "default": "both" }, "resultsLimit": { "title": "🔢 Max results per profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of rows to collect per profile. When Both is selected, this total is split between followers and following. Free plan: up to 20 rows per run (all profiles together) and 200 per month; paid plans have no limit.", "default": 20 }, "maxRetries": { "title": "🔁 Max retries per request", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of retry attempts for a failed or blocked request before giving up on that page.", "default": 3 }, "fbCUserCookie": { "title": "🔑 Facebook c_user cookie", "type": "string", "description": "Required. Your Facebook account's c_user cookie value. Provide this together with the xs cookie below." }, "fbXsCookie": { "title": "🔑 Facebook xs cookie", "type": "string", "description": "Required. Your Facebook account's xs cookie value. Provide this together with the c_user cookie above." }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Choose which proxies to use. When left on Apify proxy, the actor automatically uses a residential proxy and falls back to a datacenter proxy if needed." }, "disableDefaultProxy": { "title": "✅ Disable automatic proxy fallback", "type": "boolean", "description": "When on, the actor will not automatically apply its own residential/datacenter proxy fallback if no proxy is selected above. Leave off for typical runs.", "default": 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 } } } } } } } } } }