{ "openapi": "3.0.1", "info": { "title": "Facebook Review Scraper With Reviewer Contact Leads", "description": "Facebook Review Scraper: Extract reviews, ratings, reviewer names, dates, review text, business details, and available public contact information. Build enriched datasets to analyze customer feedback, sentiment, business reputation, and potential reviewer leads for market research.", "version": "1.0", "x-build-id": "EWfGPJWSUSzZ7c6Ej" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapevanta~facebook-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapevanta-facebook-review-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/scrapevanta~facebook-review-scraper/runs": { "post": { "operationId": "runs-sync-scrapevanta-facebook-review-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/scrapevanta~facebook-review-scraper/run-sync": { "post": { "operationId": "run-sync-scrapevanta-facebook-review-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", "properties": { "leadTargetUrl": { "title": "🎯 Facebook Page Reviews URL", "type": "string", "description": "The URL of the Facebook page reviews section to scrape (e.g., https://www.facebook.com/buladiradda/reviews). This is the primary target — it replaces the base actor's 'startUrl' field (that key still works too, see 🗄️ Base Compatibility below)." }, "requireProfileUrl": { "title": "🎯 Require Resolvable Profile", "type": "boolean", "description": "When ON, a review is DROPPED (not pushed to the dataset) if the reviewer's profileUrl could not be resolved to a real, non-null URL — so your lead export isn't diluted with unreachable contacts. When OFF (default), every review is pushed regardless of whether a profile URL was found.", "default": false }, "maxLeads": { "title": "📊 Max Reviewer Leads to Collect", "minimum": 1, "type": "integer", "description": "Maximum number of reviews (reviewer leads) to scrape. This replaces the base actor's 'maxReviews' field (that key still works too, see 🗄️ Base Compatibility below).", "default": 100 }, "proxyConfiguration": { "title": "🛡️ Proxy Configuration", "type": "object", "description": "Proxies to use so requests to Facebook succeed reliably. Actually wired into every HTTP request made by this actor (page fetch, JS-bundle fetch, GraphQL POST), with automatic IP rotation on a soft block or connection failure.", "default": { "useApifyProxy": true } }, "startUrl": { "title": "🔁 Legacy Reviews URL (base 'startUrl')", "type": "string", "description": "Same as 'Facebook Page Reviews URL' above — kept so input from the base Facebook Review Scraper still works unchanged. Leave empty if you're using 'Facebook Page Reviews URL'." }, "maxReviews": { "title": "🔁 Legacy Max Reviews (base 'maxReviews')", "minimum": 1, "type": "integer", "description": "Same as 'Max Reviewer Leads to Collect' above — kept so input from the base Facebook Review Scraper still works unchanged. Leave empty if you're using 'Max Reviewer Leads to Collect'." } } }, "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 } } } } } } } } } }