{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Scraper — Pages, Groups & Comments, No Login", "description": "Scrape posts from public Facebook Pages and Groups without login or cookies: text, media, reactions by type, comment and share counts, optional comments. Only-new-posts mode for scheduled monitoring, so you never pay twice for a post.", "version": "1.0", "x-build-id": "WVkA2mr4qSOYmAkqg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatalabs~facebook-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatalabs-facebook-posts-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/webdatalabs~facebook-posts-scraper/runs": { "post": { "operationId": "runs-sync-webdatalabs-facebook-posts-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/webdatalabs~facebook-posts-scraper/run-sync": { "post": { "operationId": "run-sync-webdatalabs-facebook-posts-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 or Group URLs", "minItems": 1, "maxItems": 200, "uniqueItems": true, "type": "array", "description": "One Page or public Group per line. Accepts full links (https://www.facebook.com/NASA, https://www.facebook.com/groups/874728723021553), m.facebook.com links, profile.php?id= links or a bare Page name like NASA. Personal profiles and private groups cannot be read without logging in and are reported as such, free of charge.", "default": [ "https://www.facebook.com/NASA" ], "items": { "type": "string" } }, "maxPostsPerSource": { "title": "Max posts per Page or Group", "minimum": 1, "maximum": 500, "type": "integer", "description": "The newest posts to collect from each Page or Group. With \"Only new posts\" on, this caps how many new posts one run delivers per source; the run tells you if more new posts were waiting.", "default": 20 }, "onlyNewPosts": { "title": "Only new posts since the last run (monitoring)", "type": "boolean", "description": "For scheduled runs: returns only posts this monitor has not delivered before, so you never pay twice for the same post. The first run returns the newest posts as the starting point. Each saved task keeps its own memory (or set a Monitor ID under Advanced).", "default": false }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Adds the newest top-level comments to each post (up to \"Max comments per post\" under Advanced). Billed per comment returned. Replies are not included.", "default": false }, "includeAuthorNames": { "title": "Include author names", "type": "boolean", "description": "Includes the name, ID and profile link of group-post authors and commenters. On by default. Turn it off to leave them out - they are personal data, so skip them if you don't need them. Page names are always included.", "default": true }, "postedAfter": { "title": "Only posts newer than", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Optional. Skips posts older than this date (2026-09-01) or period (7 days, 24 hours). Collection stops once the feed reaches older posts." }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 100, "type": "integer", "description": "Only used with \"Include comments\". The newest top-level comments, up to this many per post.", "default": 10 }, "monitorId": { "title": "Monitor ID", "pattern": "^[A-Za-z0-9_-]{0,40}$", "type": "string", "description": "Only used with \"Only new posts\". Runs that share a Monitor ID share one memory of delivered posts. Leave empty: a saved task then keeps its own memory, and a run started without a task remembers per list of links. Letters, digits, - and _ only." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxies are the default; Facebook serves logged-out pages most reliably to residential IPs. Change it only if you have your own residential or mobile pool.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }