{ "openapi": "3.0.1", "info": { "title": "Facebook Followers and Following Scraper", "description": "Extract Facebook followers and following lists easily with this Apify actor. It scrapes user profiles, follower counts, and following data from Facebook pages or profiles. Ideal for analytics, competitor tracking, or audience research with exportable results in JSON, CSV, or Excel formats.", "version": "0.1", "x-build-id": "WUpelhdtwg3h4aBbU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~facebook-followers-following-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-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/scraper-engine~facebook-followers-following-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-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/scraper-engine~facebook-followers-following-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-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 } } } } } } } } } }