{ "openapi": "3.0.1", "info": { "title": "Facebook Post Scraper by ID: Text, Comments and Reactions", "description": "Scrape Facebook posts by numeric ID. Extract text, authors, timestamps, reactions, comment counts and media URLs. Batch lookup for public group posts with JSON and CSV exports, API access and optional loaded comments.", "version": "0.1", "x-build-id": "u6kekYMOSf6Pcalgt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/whoareyouanas~facebook-single-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-whoareyouanas-facebook-single-post-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/whoareyouanas~facebook-single-post-scraper/runs": { "post": { "operationId": "runs-sync-whoareyouanas-facebook-single-post-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/whoareyouanas~facebook-single-post-scraper/run-sync": { "post": { "operationId": "run-sync-whoareyouanas-facebook-single-post-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": [ "postIds" ], "properties": { "postIds": { "title": "Post IDs", "type": "array", "description": "Required: numeric Facebook post IDs as quoted strings, for example [\"4376904415959558\"]. For a /groups/GROUP_ID/permalink/POST_ID/ URL, use POST_ID. URLs, group IDs, and pfbid identifiers are not accepted. Duplicates produce one row.", "items": { "type": "string" } }, "includeMedia": { "title": "Include media URLs", "type": "boolean", "description": "Return image and video URLs without downloading the files.", "default": true }, "includeComments": { "title": "Include loaded comments", "type": "boolean", "description": "Return comments present in the post response, up to maxComments. Does not paginate or promise all comments.", "default": false }, "maxComments": { "title": "Maximum loaded comments", "minimum": 0, "maximum": 100, "type": "integer", "description": "Limit per post, applied after deduplication.", "default": 10 }, "maxConcurrency": { "title": "Concurrent posts", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum posts in flight. Lower this when Facebook throttles requests.", "default": 5 }, "browserConcurrency": { "title": "Concurrent browser tabs", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum fallback tabs in the shared browser.", "default": 2 }, "httpTimeoutSecs": { "title": "HTTP timeout (seconds)", "minimum": 1, "maximum": 120, "type": "integer", "description": "Maximum time per HTTP attempt.", "default": 12 }, "browserTimeoutSecs": { "title": "Browser timeout (seconds)", "minimum": 1, "maximum": 120, "type": "integer", "description": "Maximum time per fallback page after browser startup and queue wait.", "default": 30 }, "maxRetries": { "title": "HTTP retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retries for transient network errors, throttling, and server errors.", "default": 1 }, "browserFallback": { "title": "Enable browser fallback", "type": "boolean", "description": "Use a browser when HTTP does not expose complete data. Successful browser results cost $0.04 instead of $0.005 for HTTP results. Disable for HTTP-only pricing.", "default": true }, "proxyUrl": { "title": "Proxy URL", "type": "string", "description": "Optional HTTP(S) proxy URL used for both HTTP and browser requests. Use sticky session credentials where supported." }, "cookies": { "title": "Facebook cookies", "type": "array", "description": "Optional cookies supplied by you for posts accessible to your account. Browser-extension cookie format is supported." }, "proxyConfiguration": { "title": "Apify Proxy", "type": "object", "description": "Residential Apify Proxy is enabled by default for cloud runs, using runtime credentials. Built-in proxy usage is included in Actor event pricing. Datacenter IPs may receive Facebook login restrictions. Disable explicitly for direct requests. The tested default country is India (IN); you can select another region.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } } }, "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 } } }, "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 } } } } } } } } } }