{ "openapi": "3.0.1", "info": { "title": "Facebook Page Post & Comment Scraper", "description": "⚡ High-Speed Facebook Page Scraper — 100+ Page URLs in One Run. Collect post text, media, timestamps, authors, engagement metrics, videos, reels, shared posts, and optional transcripts — no login or cookies required. Built for fast bulk scraping and automation.", "version": "1.0", "x-build-id": "eCMr5JvG1kprkec3A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thedoor~facebook-page-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thedoor-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/thedoor~facebook-page-scraper/runs": { "post": { "operationId": "runs-sync-thedoor-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/thedoor~facebook-page-scraper/run-sync": { "post": { "operationId": "run-sync-thedoor-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": [ "pageUrls" ], "properties": { "pageUrls": { "title": "Facebook Page URLs", "type": "array", "description": "Enter the URLs of the Facebook pages you want to scrape. One URL per line.", "items": { "type": "string" } }, "postsToScrape": { "title": "Number of Posts", "minimum": 1, "type": "integer", "description": "The maximum number of posts to scrape from each page.", "default": 100 }, "onlyNewPosts": { "title": "Only new posts on my next run", "type": "boolean", "description": "Turn this on to get only new posts when you run the same Page again. Your first run gets posts as usual. Every next run gets only posts published after your last run, never the old ones, so you don't pay for them twice. Great for scheduled runs that monitor a Page.", "default": false }, "includeTranscript": { "title": "Include video transcript", "type": "boolean", "description": "Download available Facebook video captions and return them in videoTranscript.", "default": false }, "includeTopComment": { "title": "Include top comment", "type": "boolean", "description": "Add the top comment available for each post.", "default": true }, "fetchAllComments": { "title": "Fetch comments", "type": "boolean", "description": "Collect up to 100 top-level comments for every returned post, in Facebook's All comments order. Turn on Fetch comment replies to include their replies too.", "default": false }, "fetchCommentReplies": { "title": "Fetch comment replies", "type": "boolean", "description": "Also collect replies to each returned comment (up to 100 comments per post). Fetch comments must be enabled. This can make the run take longer.", "default": false }, "postsNewerThan": { "title": "Posts newer than", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+(?:\\.\\d+)?)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Choose Relative or Absolute. Relative accepts values such as 7 days; Absolute accepts YYYY-MM-DD." }, "postsOlderThan": { "title": "Posts older than", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+(?:\\.\\d+)?)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Get only posts published on or before this date. Absolute accepts YYYY-MM-DD and includes that whole day (UTC); Relative accepts values such as 7 days. Combine with Posts newer than for a date range. Facebook usually returns posts from this date directly. When it does not, the scraper loads the newer posts first to reach the date: those are not returned, and each one is charged at $1 per 1,000 posts (out-of-time-frame post)." } } }, "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 } } } } } } } } } }