{ "openapi": "3.0.1", "info": { "title": "Facebook Followers Scraper", "description": "Facebook Followers Scraper SD - Facebook Followers Scraper is a social media data tool that extracts the followers and following lists of public Facebook pages and public figures (name, profile link, username, photo, verified badge) and tracks follower counts over time, no login.", "version": "1.0", "x-build-id": "F3FvE1BifaSOx7Bwe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuro-scraper~facebook-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuro-scraper-facebook-followers-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/neuro-scraper~facebook-followers-scraper/runs": { "post": { "operationId": "runs-sync-neuro-scraper-facebook-followers-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/neuro-scraper~facebook-followers-scraper/run-sync": { "post": { "operationId": "run-sync-neuro-scraper-facebook-followers-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": { "startUrls": { "title": "Pages or profiles", "type": "array", "description": "Public page or profile URLs (www, m., profile.php?id=), usernames, numeric ids, or direct .../followers and .../following links, one per line.", "items": { "type": "string" } }, "mode": { "title": "What to extract", "enum": [ "lists", "counts" ], "type": "string", "description": "The lists themselves, or a count tracker for monitoring growth.", "default": "lists" }, "lists": { "title": "Lists to collect", "enum": [ "followers", "following", "both" ], "type": "string", "description": "Which list of each page or profile (a direct /followers or /following link always reads that list).", "default": "followers" }, "maxFollowers": { "title": "Followers per page or profile", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Facebook returns 8 per request logged out (measured).", "default": 50 }, "maxFollowing": { "title": "Following per page or profile", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Accounts the page or profile follows.", "default": 50 }, "includeProfileDetails": { "title": "Add each person's profile details", "type": "boolean", "description": "Open every listed account and add its category, followers, contacts, city, work ... (one extra request each; ordinary personal profiles are not public logged out).", "default": false }, "onlyNewFollowers": { "title": "Only accounts not delivered before", "type": "boolean", "description": "Remember delivered accounts per list (named key-value store \"facebook-followers-scraper-state\") and return only new ones in later runs.", "default": false }, "includeTransparency": { "title": "Counts mode: add Page transparency", "type": "boolean", "description": "Creation date, \"running ads\" status and confirmed owner from the Page transparency tab (one extra request of about 16 MB per Page).", "default": false }, "checkAdsLibrary": { "title": "Counts mode: check active ads (Meta Ad Library)", "type": "boolean", "description": "For Pages: add hasActiveAds from the public Ad Library (one extra request per Page).", "default": false }, "historyDepth": { "title": "Counts mode: history entries per page", "minimum": 0, "maximum": 365, "type": "integer", "description": "Also attach the last N counts recorded by earlier runs of this Actor.", "default": 0 }, "maxTotalItems": { "title": "Max results in total (0 = no total limit)", "minimum": 0, "type": "integer", "description": "Stops the whole run after this many dataset rows (all inputs together).", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Facebook limits logged-out visitors per IP address. Residential proxies (the default) give the most reliable results; the Actor switches to a fresh IP when Facebook refuses one.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }