{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Scraper", "description": "Facebook Posts Scraper — Extract Facebook post data including text, captions, reactions, comments, shares, timestamps, media URLs, page or profile details, and post links. Useful for content research, competitor analysis, audience insights, and social media monitoring.", "version": "0.3", "x-build-id": "g68MJUOqikZ0yhZrl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialdataapi~facebook-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialdataapi-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/socialdataapi~facebook-posts-scraper/runs": { "post": { "operationId": "runs-sync-socialdataapi-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/socialdataapi~facebook-posts-scraper/run-sync": { "post": { "operationId": "run-sync-socialdataapi-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 URLs or usernames", "type": "array", "description": "One or more public Facebook Pages or profiles, one per line. Accepts a full URL (https://www.facebook.com/nytimes, or a profile.php?id=... link) or a bare username (nytimes). Duplicates are removed. Groups are not supported.", "items": { "type": "string" } }, "resultsLimit": { "title": "🔢 Maximum posts (total)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop once this many posts have been saved in total, across all targets combined. Up to 3 targets are read at the same time and each one adds its newest posts when it finishes, so the target that finishes first fills the total first. Free plan: up to 20 posts per run (all targets together) and 200 per month; paid plans have no limit.", "default": 50 }, "captionText": { "title": "✅ Include post text", "type": "boolean", "description": "On by default. When on, each post's text is returned (for a share without its own text, the shared post's text). When off, the text is returned empty, which is useful when you only need engagement counts and media.", "default": true }, "onlyPostsNewerThan": { "title": "📅 Posts newer than", "type": "string", "description": "Only include posts published at or after this point in time (UTC). Absolute: YYYY-MM-DD (means 00:00 UTC that day), optionally with a time (YYYY-MM-DD HH:MM). Relative: e.g. '30 days', '2 weeks', '1 year' before the run starts. Leave empty for no lower bound." }, "onlyPostsOlderThan": { "title": "📅 Posts older than", "type": "string", "description": "Only include posts published at or before this point in time (UTC). A date alone means 00:00 UTC that day, so '2026-10-04' keeps posts up to the end of 3 October. Same formats as 'Posts newer than'. Leave empty for no upper bound." }, "proxyConfiguration": { "title": "🌐 Proxy (always residential)", "type": "object", "description": "This actor always uses Apify Residential proxies for every request, whatever is selected here, including when the proxy is turned off or your own proxy URLs are entered. A request that fails is retried up to 3 times, each time on a new residential IP. Only a proxy country chosen here is used. The field is kept for compatibility with saved inputs." } } }, "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 } } } } } } } } } }