{ "openapi": "3.0.1", "info": { "title": "Facebook Comments Analyzer (AI)", "description": "Turn Facebook post and ad comments into a brand-ready report: objections to answer, mood weighted by likes, top questions as a ready FAQ, buying intent, complaints, spam share and reply drafts. Use a Facebook Comments Scraper dataset or post URLs. $0.80 per 1,000 comments. Free demo.", "version": "0.1", "x-build-id": "qdShc2O1UFMAiv1XK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalsift~facebook-comments-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalsift-facebook-comments-analyzer", "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/signalsift~facebook-comments-analyzer/runs": { "post": { "operationId": "runs-sync-signalsift-facebook-comments-analyzer", "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/signalsift~facebook-comments-analyzer/run-sync": { "post": { "operationId": "run-sync-signalsift-facebook-comments-analyzer", "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", "properties": { "postUrls": { "title": "Facebook post URLs", "type": "array", "description": "Links to public posts, videos, reels or photos, ads included: open the ad, click its date and copy the link. Ad Library links don't work.", "default": [], "items": { "type": "string" } }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Top-level comments to scrape per post. Replies come on top. 1 to 20,000.", "default": 500 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also scrape replies, which shows where your Page already answered. Replies are not limited by the setting above: a post with 12 comments returned 510 replies in our test, and Facebook Comments Scraper bills each one ($2.50 per 1,000 on Free). The scraper's cost is capped at 'Max comments to analyze' comments.", "default": false }, "yourPageName": { "title": "Your Facebook Page", "type": "string", "description": "Your Page's name or link (for example Northwind Coffee or https://www.facebook.com/northwindcoffee). Its comments are left out of the audience numbers, reply drafts and charges, and comments it already answered get no draft. The post's own Page is recognized from the post link when the link contains your Page's name or ID (facebook.com/yourpage/posts/…); otherwise, and for video, reel or share links, give your Page's name, link or numeric Page ID here. Several Pages: separate them with commas. Used only for matching; never saved in the results." }, "maxComments": { "title": "Max comments to analyze", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total cap for this run, replies included. Your spending limit can lower it further.", "default": 5000 }, "commentsSince": { "title": "Only comments posted since", "type": "string", "description": "Analyze only comments posted since this date. Facebook Comments Scraper then scrapes only those, and bills its date filter as an add-on ($2.00 per 1,000 comments on Free)." }, "draftReplies": { "title": "Draft replies to questions and complaints", "type": "boolean", "description": "Write a short, friendly reply draft for the most liked questions and complaints you have not answered yet.", "default": true }, "maxReplyDrafts": { "title": "Max reply drafts", "minimum": 0, "maximum": 100, "type": "integer", "description": "Most liked unanswered questions and complaints to draft replies for. 0 to 100.", "default": 25 }, "reportLanguage": { "title": "Theme name language", "type": "string", "description": "Language for theme names, as a code such as en, de or es. Report headings are in English; quotes stay in each comment's own language.", "default": "en" }, "datasetId": { "title": "Dataset ID", "type": "string", "description": "ID of a dataset produced by Facebook Comments Scraper (apify/facebook-comments-scraper). When this Actor runs as an integration after that scraper, the dataset is passed automatically." } } }, "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 } } } } } } } } } }