{ "openapi": "3.0.1", "info": { "title": "Facebook Comment Scraper", "description": "Scrape every comment and reply from public Facebook posts, reels, videos and photos with no login or cookies. Get text, author, reactions, media, links and contacts. Rebuild threads, filter by date or keyword, bulk URLs. JSON for sentiment analysis and lead research.", "version": "1.0", "x-build-id": "WFQtlHkju2ci5aFKI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_wiki~facebook-comment-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_wiki-facebook-comment-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/data_wiki~facebook-comment-scraper/runs": { "post": { "operationId": "runs-sync-data_wiki-facebook-comment-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/data_wiki~facebook-comment-scraper/run-sync": { "post": { "operationId": "run-sync-data_wiki-facebook-comment-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": [ "urls" ], "properties": { "urls": { "title": "🔗 Post links", "minItems": 1, "type": "array", "description": "Facebook post, reel, video, photo or share links (posts of pages, profiles and public groups work). Add one link or hundreds; they can be mixed in one run.", "items": { "type": "string" } }, "orderingMode": { "title": "🧭 Comment order", "enum": [ "MOST_RELEVANT", "NEWEST", "ALL" ], "type": "string", "description": "Which order Facebook lists the comments in. 'All comments' returns the most replies.", "default": "ALL" }, "targetComments": { "title": "🧮 Comments per post", "minimum": -1, "type": "integer", "description": "How many comments to save per post. Replies to those comments are saved on top and do not count towards this number. Use -1 (or 0) for everything.", "default": 10 }, "includeReplies": { "title": "↩ī¸ Include replies", "type": "boolean", "description": "Save the replies of every saved comment as their own rows, right after the comment. They do not count towards 'Comments per post'. The parent comment id links each reply to its comment.", "default": true }, "maxRepliesPerComment": { "title": "đŸŒŋ Replies per comment", "minimum": 0, "type": "integer", "description": "Most replies to keep under each comment. 0 keeps every reply Facebook shows.", "default": 0 }, "includeReactions": { "title": "😍 Include reactions", "type": "boolean", "description": "Add the total reaction count and the Like, Love, Haha and other reaction breakdown to each row.", "default": true }, "newerThan": { "title": "📅 Only comments newer than", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Keep comments posted after this moment. Use a date such as 2026-01-01 or a relative value such as 3 days or 2 months. Leave empty for no limit." }, "olderThan": { "title": "⌛ Only comments older than", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Keep comments posted before this moment. Same formats as 'newer than'. Leave empty for no limit." }, "keywords": { "title": "🔤 Keywords", "type": "array", "description": "Keep only comments that contain any of these words or phrases. Leave empty to keep all.", "items": { "type": "string" } }, "minReactions": { "title": "đŸ”Ĩ Minimum reactions", "minimum": 0, "type": "integer", "description": "Keep only comments with at least this many reactions. 0 keeps all.", "default": 0 }, "onlyWithMedia": { "title": "đŸ–ŧī¸ Only comments with media", "type": "boolean", "description": "Keep only comments that carry a photo, GIF, sticker or video.", "default": false }, "resumeCursors": { "title": "⏭ī¸ Resume cursors", "type": "object", "description": "Continue a capped run: paste the 'resumeCursors' object from the previous run's SUMMARY record, as {\"post link\": \"cursor\"}.", "default": {} }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Choose how requests are routed. If a request is blocked, the Actor switches to another connection automatically.", "default": { "useApifyProxy": 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 } } } } } } } } } }