{ "openapi": "3.0.1", "info": { "title": "Facebook Post Comments Scraper — Reactions, Replies, No Login", "description": "Comments of public Facebook posts, most relevant or newest first: author (name, id, address, verification, picture — or a code instead), text, exact time, depth, reply count, reactions in total and by kind; the post itself with its counts as a row of its own. Only-new mode. No login.", "version": "0.1", "x-build-id": "dWxhKADZPfb8OL0Xy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~facebook-post-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-facebook-post-comments-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/foxlabs~facebook-post-comments-scraper/runs": { "post": { "operationId": "runs-sync-foxlabs-facebook-post-comments-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/foxlabs~facebook-post-comments-scraper/run-sync": { "post": { "operationId": "run-sync-foxlabs-facebook-post-comments-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": [ "posts" ], "properties": { "posts": { "title": "Posts", "type": "array", "description": "One post per line: its address in any form Facebook uses (…/posts/…, …/videos/…, …/photos/…, /reel/…, permalink.php, a share link) or its numeric id. A post written twice is read once. Only posts of public Pages that Facebook shows to visitors who are not signed in can be read.", "items": { "type": "string" } }, "maxCommentsPerPost": { "title": "Maximum comments per post", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many comments to deliver for each post. Facebook hands them out ten a call; the first ten of the \"most relevant\" order come with the post's page itself.", "default": 100 }, "maxComments": { "title": "Maximum comments in total", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The run stops when this many comment rows have been delivered. You are charged only for delivered rows.", "default": 100000 }, "order": { "title": "Order", "enum": [ "relevant", "newest", "all" ], "type": "string", "description": "Facebook's own orders: most relevant (the default, what the site shows), newest first, or all comments in Facebook's \"all comments\" order.", "default": "relevant" }, "includePost": { "title": "Deliver the post itself as a row", "type": "boolean", "description": "One row of type \"post\" per input post, with its text, time, reactions by kind, comment and share counts (billed as a post event). Off: comment rows only.", "default": true }, "hideAuthors": { "title": "Replace commenters' names with codes", "type": "boolean", "description": "Each commenter's name, id, address and picture are replaced by a code that is the same for the same person (threads stay readable). Use it when you do not need who wrote what.", "default": false }, "authorCodeKey": { "title": "Key for the author codes (optional)", "maxLength": 200, "type": "string", "description": "With \"Replace commenters' names with codes\": runs that share this key give the same person the same code. Leave empty for the Actor's own key." }, "minReactions": { "title": "Minimum reactions (optional)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Deliver only comments with at least this many reactions. Leave empty for every comment." }, "onlyNewComments": { "title": "Only comments not delivered before", "type": "boolean", "description": "Remember delivered comments under the list name below and skip them in later runs. Schedule the same posts and each run brings only the comments it has not delivered before (with \"newest first\" the new ones come first). With this on, \"Maximum comments per post\" is how far the Actor looks.", "default": false }, "listName": { "title": "List name", "pattern": "^[A-Za-z0-9]([A-Za-z0-9-]{0,38}[A-Za-z0-9])?$", "type": "string", "description": "Name of the memory used by \"Only comments not delivered before\" (looked at only when that is on). Letters, digits and hyphens (a hyphen not first or last), up to 40 characters; capitals are read as lower case.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Nothing to change for normal use: the Actor reads Facebook through Apify Proxy residential addresses, the only kind Facebook serves its public posts to (measured: residential 25 of 25 requests, datacenter 0 — sent to the login page). Set a proxy here to send every request through it instead." } } }, "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 } } } } } } } } } }