{ "openapi": "3.0.1", "info": { "title": "Facebook Page Post Scraper", "description": "Powerful Facebook Page scraper that extracts posts, engagement metrics (likes, comments, shares), images, videos, and posting dates from any public Facebook Page. Perfect for competitive analysis, content research, and social media monitoring.", "version": "1.0", "x-build-id": "tgxD0eIaYeRloVVqU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~facebook-page-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-facebook-page-post-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/alizarin_refrigerator-owner~facebook-page-post-scraper/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-facebook-page-post-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/alizarin_refrigerator-owner~facebook-page-post-scraper/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-facebook-page-post-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": { "pageUrls": { "title": "Page URLs", "type": "array", "description": "List of Facebook Page URLs to scrape (e.g., https://www.facebook.com/meta)", "items": { "type": "string" } }, "pageUsernames": { "title": "Page Usernames", "type": "array", "description": "List of Facebook Page usernames/handles (e.g., 'meta', 'nike')", "items": { "type": "string" } }, "maxPostsPerPage": { "title": "Max Posts Per Page", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of posts to scrape per page", "default": 25 }, "includeComments": { "title": "Include Comments", "type": "boolean", "description": "Scrape top comments for each post", "default": false }, "maxCommentsPerPost": { "title": "Max Comments Per Post", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum comments to scrape per post (if comments enabled)", "default": 10 }, "dateFrom": { "title": "Date From", "type": "string", "description": "Only scrape posts from this date onwards (YYYY-MM-DD)" }, "dateTo": { "title": "Date To", "type": "string", "description": "Only scrape posts up to this date (YYYY-MM-DD)" }, "contentType": { "title": "Content Type Filter", "enum": [ "all", "text_only", "with_images", "with_videos", "with_links" ], "type": "string", "description": "Filter posts by content type", "default": "all" }, "sessionCookies": { "title": "Session Cookies (JSON)", "type": "string", "description": "JSON array of cookies from Cookie-Editor browser extension. REQUIRED — Facebook gates Page feeds behind login. Install Cookie-Editor, log into Facebook, export cookies, paste here." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to POST results (Zapier, Make, n8n, or custom endpoint)" }, "webhookPlatform": { "title": "Webhook Platform", "enum": [ "zapier", "make", "n8n", "custom" ], "type": "string", "description": "Target platform for webhook payload formatting", "default": "custom" }, "webhookHeaders": { "title": "Webhook Headers", "type": "object", "description": "Custom HTTP headers to send with webhook (JSON object)" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for scraping", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Return sample data without actual scraping (for testing)", "default": true }, "cookieStorageKey": { "title": "Cookie Manager Storage Key", "type": "string", "description": "Key in the KV store to load cookies from (created by Cookie Manager actor). If provided and no manual sessionCookies are set, cookies will be loaded automatically from the KV store." }, "cookieKvStoreName": { "title": "Cookie KV Store Name", "type": "string", "description": "Name of the Apify Key-Value store holding cookie sessions. Default: 'cookie-sessions'", "default": "cookie-sessions" } } }, "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 } } } } } } } } } }