{ "openapi": "3.0.1", "info": { "title": "Facebook Comments Scraper", "description": "Facebook Comments Scraper extracts comments from public Facebook posts. Collect comment text, usernames, timestamps, reactions, and reply threads. Ideal for sentiment analysis, audience research, engagement tracking, and social media monitoring.", "version": "0.1", "x-build-id": "wBbi3kpCSe2DZhBnN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~facebook-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-facebook-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/scrapio~facebook-comments-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-facebook-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/scrapio~facebook-comments-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-facebook-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": [ "startUrls" ], "properties": { "startUrls": { "title": "πŸ”— Paste your Facebook post / video links", "type": "array", "description": "πŸ“‹ One URL per line β€” bulk paste from a spreadsheet is welcome.\n\nβœ… Works with typical **post**, **photo**, and **reel** permalinks from facebook.com.\n\nπŸ’‘ **Pro tip:** run a small test first, then scale up your max comments.", "items": { "type": "string" } }, "commentSettings": { "title": "πŸ“Š Comments limits & sort order", "type": "object", "description": "▢️ **One panel** β€” max comments, reply depth, and sort order live together. Tap the header to expand or collapse.", "properties": { "maxComments": { "title": "πŸ’¬ Max comments per post", "type": "integer", "description": "🎯 Hard cap on top-level comments **per** URL β€” lower = faster; higher = deeper threads.", "editor": "number", "default": 10, "minimum": 1 }, "maxRepliesPerComment": { "title": "↩️ Max replies per comment", "type": "integer", "description": "🧡 Nested replies to fetch per threaded comment β€” use a **large number** for β€œeffectively all”.", "editor": "number", "default": 1, "minimum": 0 }, "commentsSortOrder": { "title": "πŸ“Š Comment order", "type": "string", "description": "πŸ”€ Ordering where supported β€” pick what fits your analysis.", "editor": "select", "enum": [ "most_relevant", "newest", "all" ], "enumTitles": [ "⭐ Most relevant (Facebook default vibe)", "πŸ†• Newest first", "πŸ“œ All / original flow" ], "default": "all" } } }, "onlyCommentsNewerThan": { "title": "πŸ“… Extract comments that are newer than", "type": "string", "description": "Pick a date (Absolute, e.g. `2024-01-15`) or a relative window (Relative, e.g. `1 day`, `2 weeks`, `3 months`). Only comments and replies posted **after** this point will be kept. Leave blank to disable.\n\nℹ️ Filtering happens after comments are fetched, so set `maxComments` generously for narrow windows." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "ℹ️ Informational only β€” the scraper **always** attaches Apify **residential** proxy at runtime regardless of what is selected here. Tap the header above to expand or collapse this section." } } }, "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 } } } } } } } } } }