{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Scraper - Pages & Date Range", "description": "Scrape posts from public Facebook pages with a date range, page details and optional comments and replies. No login or cookies.", "version": "1.0", "x-build-id": "NwaQBbQ3Uw75ThTUa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/icoe-man~facebook-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-icoe-man-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/icoe-man~facebook-posts-scraper/runs": { "post": { "operationId": "runs-sync-icoe-man-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/icoe-man~facebook-posts-scraper/run-sync": { "post": { "operationId": "run-sync-icoe-man-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": [ "pageUrls" ], "properties": { "pageUrls": { "title": "Facebook page URLs", "type": "array", "description": "Links to public Facebook pages (https://www.facebook.com/NASA or profile.php?id=...), or just the page username or id, one per line. Up to 200 per run.", "default": [ "https://www.facebook.com/NASA" ], "items": { "type": "string" } }, "sections": { "title": "Sections", "type": "array", "description": "Which parts of each page to collect: the page's own posts (feed) and, for pages that show them, its reviews and the posts that mention it. Reviews and mentions are often empty. Max posts per page applies to each section separately.", "items": { "type": "string", "enum": [ "feed", "reviews", "mentions" ], "enumTitles": [ "Posts (feed)", "Reviews", "Mentions" ] }, "default": [ "feed" ] }, "maxPostsPerPage": { "title": "Max posts per page (per section)", "minimum": 1, "maximum": 300, "type": "integer", "description": "How many posts to collect from each selected section of each page, so 2 sections give up to twice this number. Each post is billed, plus a small fee per page.", "default": 25 }, "onlyNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Skip posts published before this date, in every selected section. Use a date like 2026-01-31 or a relative value like \"7 days\"." }, "onlyOlderThan": { "title": "Only posts older than (feed)", "type": "string", "description": "Feed only: skip posts published after this date, e.g. 2026-06-30 or \"1 month\". Combine both fields for a date range." }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also collect the comments of every post. Each comment is billed, plus a small fee per post whose comments we collect.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many comments (and replies, if enabled) to collect per post when Include comments is on. Facebook shows a most-relevant selection, often fewer than the post's comment count. Up to 24 is fastest.", "default": 24 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also collect replies to comments when Include comments is on. Replies count toward the comment limit.", "default": false }, "maxDataAgeHours": { "title": "Reuse data collected within (hours)", "minimum": 0, "maximum": 720, "type": "integer", "description": "If we collected these posts within this many hours, you get them instantly at the same price. Use 0 to always collect fresh data.", "default": 24 }, "cacheOnly": { "title": "Previously collected data only (instant)", "type": "boolean", "description": "Return only posts we already collected, without waiting for live collection. Useful for AI agents with short timeouts.", "default": false } } }, "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 } } } } } } } } } }