{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Scraper: Pages, Comments & Contacts", "description": "Get posts from public Facebook pages: text, reactions by type, comments, shares, views and media, plus page details with followers, contacts, rating and creation date. Monitor new posts.", "version": "0.1", "x-build-id": "RUMSrc76yX1uPHkh8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stratumics~facebook-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stratumics-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/stratumics~facebook-posts-scraper/runs": { "post": { "operationId": "runs-sync-stratumics-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/stratumics~facebook-posts-scraper/run-sync": { "post": { "operationId": "run-sync-stratumics-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", "properties": { "pageUrls": { "title": "Facebook pages", "type": "array", "description": "Public pages to read, one per line: links (facebook.com/nasa, facebook.com/profile.php?id=...) or usernames (nasa). Each page gives one page row with its details and its newest posts.", "default": [], "items": { "type": "string" } }, "postUrls": { "title": "Post links", "type": "array", "description": "Single public posts to read, one per line: links to posts, photos, videos or reels. Each gives one post row (and its comments when Include comments is on).", "default": [], "items": { "type": "string" } }, "maxPostsPerPage": { "title": "Maximum posts per page", "minimum": 0, "maximum": 10000, "type": "integer", "description": "How many of each page's newest posts to save. Set 0 to save page details only.", "default": 20 }, "newerThan": { "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": "Save only posts published on or after this date (UTC), or within a period back from now such as \"7 days\", \"2 weeks\" or \"12 hours\". Reading a page stops at its first older posts, so a short period also keeps the run cheap." }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also save the comments Facebook shows logged-out visitors under each post: the most relevant ones, usually about 10 a post. Takes one more page load per post with comments.", "default": false }, "maxCommentsPerPost": { "title": "Maximum comments per post", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of a post's shown comments to save. Facebook shows logged-out visitors about 10 per post, so higher numbers rarely add more.", "default": 10 }, "includePageDetails": { "title": "Include page details", "type": "boolean", "description": "Save one row per page with its name, category, followers, likes, intro, contact details shown on the page (email, phone, website, address), rating, creation date, ad status and photos. Turn off to save posts only.", "default": true }, "onlyNewPosts": { "title": "Only new posts", "type": "boolean", "description": "For scheduled runs: save only posts that earlier runs with the same pages have not saved. Reading each page stops at the first post saved before, and each page read costs a page check ($0.001) whether or not it has new posts; new posts cost the post price. With page details off, later runs read each page's timeline directly, without loading the page. Applies to pages; post links are always read. The Actor remembers post ids and pages in the key-value store facebook-posts-monitor.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. A name for the remembered list, so different schedules keep separate histories even with the same pages. Leave empty to derive it from the inputs.", "default": "" }, "maxConcurrency": { "title": "Pages at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages and post links are read at the same time. Each page's posts are read one batch after another.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave Apify Proxy on: the Actor then loads pages over Apify datacenter proxy (residential when Facebook shows its login page) and the timeline after each page's newest post over Apify residential proxy, which Facebook requires; both are included in the price. Your own proxy groups or URLs carry every request instead; with datacenter addresses only, expect just each page's newest post.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }