{ "openapi": "3.0.1", "info": { "title": "Facebook Followers & Following Scraper", "description": "Scrapes both followers and following lists from any public Facebook profile or page, capturing names, profile URLs, follower counts, and engagement data. Ideal for audience mapping, competitor analysis, influencer research, and automated network insights", "version": "0.1", "x-build-id": "e70hjLrziBJbf3ILH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~facebook-followers-following-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-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/scrapio~facebook-followers-following-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-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/scrapio~facebook-followers-following-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-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" ], "properties": { "startUrls": { "title": "🔗 Profile URLs, usernames, or keywords", "type": "array", "description": "📝 **Who should we look at?**\n\n• Paste **Facebook profile links** (`facebook.com/...`) ✓\n• Or type **usernames** (e.g. `LeonardoDiCaprio`) ✓\n• **Keywords** can be used to **filter** names in your results later ✓\n\n🧩 Add **one row per profile** — run once, collect everyone you listed.\n\n💡 *Tip:* Full `https://` URLs work best if you’re unsure.", "items": { "type": "string" } }, "collection": { "title": "Collection", "type": "object", "description": "What to collect and how many rows per profile.", "properties": { "followType": { "title": "👥 Relation type", "type": "string", "description": "🎛️ **Pick what relationship list you need:**\n\n• 👥 **Both** — followers *and* following (limit is shared across both)\n• ⬇️ **Followers** — people who follow this profile\n• ⬆️ **Following** — accounts this profile follows\n\n✨ Choose what matches your campaign or research goal.", "enum": [ "both", "followers", "following" ], "enumTitles": [ "🔄 Both followers & following", "👥 Only followers", "➡️ Only following" ], "default": "both", "editor": "select" }, "resultsLimit": { "title": "🔢 Results limit", "type": "integer", "description": "🎚️ **How many people per profile?** (max per profile, not global)\n\n• When **Both** is selected, the total is **split** between followers and following so you stay within budget.\n\n📊 Raise this for large lists — lower it for quick samples.", "minimum": 1, "maximum": 100000, "default": 10 } } }, "network": { "title": "Proxy & network", "type": "object", "description": "Connection and proxy options for this run.", "properties": { "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "🌍 **Optional — tune how this run connects to the web.**\n\n✅ **Recommended:** use Apify’s proxy options when you need stable, region-friendly sessions.\n\n💡 If you **don’t** enable a custom proxy here, the Actor still applies **sensible defaults** on the platform so runs behave well for social data — you can usually leave this as-is.\n\n🔧 Power users: pick groups or countries that match your compliance and billing setup.", "editor": "proxy", "prefill": { "useApifyProxy": false } }, "disableDefaultProxy": { "title": "⛔ Disable automatic proxy fallback", "type": "boolean", "description": "🧪 **Expert toggle** — only turn **ON** if you truly need a **direct** connection with **no** default platform proxy behavior.\n\n⚠️ Disabling may reduce success rates for some profiles.\n\n✨ 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 } } }, "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 } } } } } } } } } }