{ "openapi": "3.0.1", "info": { "title": "Facebook Page Scraper", "description": "Scrape public Facebook page/profile URLs into clean page profile records plus optional recent post records. Extracts names, categories, contacts, websites, followers, likes, ratings, ad status, post text, timestamps, engagement counts, media, and links. No login required. MCP-ready.", "version": "1.0", "x-build-id": "7IyYiqEMCg6Lf4OVr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~facebook-page-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-facebook-page-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/khadinakbar~facebook-page-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-facebook-page-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/khadinakbar~facebook-page-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-facebook-page-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": "Facebook page URLs", "type": "array", "description": "One or more public Facebook page or profile URLs. Direct post, group, marketplace, and search URLs are ignored because this actor is scoped to pages/profiles. Private, deleted, age-gated, or login-only pages may return no data.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "resultsLimit": { "title": "Total records limit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of dataset records to emit across page and post records. Use this as the primary cost cap.", "default": 100 }, "includePosts": { "title": "Include recent posts", "type": "boolean", "description": "When enabled, the actor emits recent post records for each page after the page profile record.", "default": true }, "maxPostsPerPage": { "title": "Max posts per page", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of recent public posts to collect from each page. Set to 0 with Include recent posts disabled for pure page enrichment.", "default": 25 }, "scrapePostDetails": { "title": "Open post details in HTML fallback", "type": "boolean", "description": "HTML fallback option. Opens each discovered post URL to enrich media, outbound links, and engagement counts. Provider-backed posts are already returned as structured records.", "default": false }, "getBusinessHours": { "title": "Get business hours", "type": "boolean", "description": "Provider option. Requests business hours for pages when the public provider endpoint exposes them.", "default": false }, "fallbackProvider": { "title": "Provider mode", "enum": [ "auto", "none", "scrapeCreators", "sociaVault" ], "type": "string", "description": "auto uses SCRAPECREATORS_API_KEY first and SOCIAVAULT_API_KEY second when configured, then falls back to public HTML. none disables provider calls and uses public HTML only.", "default": "auto" }, "onlyPostsNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Optional post date filter. Accepts ISO dates such as 2026-01-01 or natural JavaScript date strings. Posts with unparseable timestamps are kept." }, "onlyPostsOlderThan": { "title": "Only posts older than", "type": "string", "description": "Optional upper post date filter. Accepts ISO dates such as 2026-06-01 or natural JavaScript date strings. Posts with unparseable timestamps are kept." }, "includeRawHtml": { "title": "Include raw HTML", "type": "boolean", "description": "Debug option for HTML fallback. Adds a truncated rawHtml field to page/detail records. Leave disabled for normal runs because raw HTML increases dataset size.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings for HTML fallback requests. Residential Apify Proxy is the default because Facebook often blocks datacenter IPs and local network ranges.", "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 } } }, "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 } } } } } } } } } }