{ "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper & Sentiment Analyzer", "description": "Scrape and analyze public Google Maps reviews from up to 10 business URLs. Get multilingual positive, neutral, and negative sentiment, confidence scores, rating breakdowns, and structured JSON. Pay only for reviews analyzed.", "version": "0.6", "x-build-id": "wuwVmgsFpYsVNlJeA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datascraperes~google-maps-review-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datascraperes-google-maps-review-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/datascraperes~google-maps-review-analyzer/runs": { "post": { "operationId": "runs-sync-datascraperes-google-maps-review-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/datascraperes~google-maps-review-analyzer/run-sync": { "post": { "operationId": "run-sync-datascraperes-google-maps-review-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", "required": [ "urls" ], "properties": { "urls": { "title": "Google Maps business URLs (1–10)", "minItems": 1, "maxItems": 10, "uniqueItems": true, "type": "array", "description": "Each line must contain one complete HTTPS Google Maps business listing URL. Standard /maps/place/ links, maps.app.goo.gl short links, and goo.gl/maps links are accepted. Add one line for a single business or up to 10 different lines for batch processing. Duplicate URLs are rejected.", "items": { "type": "string", "minLength": 12, "maxLength": 4096, "pattern": "^https://(?:(?:maps\\.app\\.goo\\.gl)/\\S+|goo\\.gl/maps/\\S+|(?:(?:www|maps)\\.)?google\\.(?:com|[a-z]{2,3}|com\\.[a-z]{2}|co\\.[a-z]{2})/maps(?:/place(?:[/?#]\\S*)?|[/?#].*(?:place_id|placeid|cid|ludocid).*)?)$" }, "default": [ "https://www.google.com/maps/place/?q=place_id:ChIJ--511_65pBIR4Tl2-D4grUw" ] }, "maxReviews": { "title": "Maximum reviews", "minimum": 1, "type": "integer", "description": "Maximum number of unique reviews to collect and analyze incrementally. There is no fixed per-business review cap. Collection remains subject to Google availability, the run timeout, and your spending limit.", "default": 100 }, "sort": { "title": "Review order", "enum": [ "relevance", "recent", "highest", "lowest" ], "type": "string", "description": "Order requested from the Google Maps review endpoint.", "default": "recent" }, "language": { "title": "Google language", "pattern": "^[a-zA-Z]{2,5}$", "maxLength": 5, "type": "string", "description": "Two-letter language code used in Google Maps requests.", "default": "es" }, "country": { "title": "Google country", "pattern": "^[a-zA-Z]{2}$", "maxLength": 2, "type": "string", "description": "Two-letter country code used to localize Google Maps requests.", "default": "ES" }, "includeRawReviews": { "title": "Include review records", "type": "boolean", "description": "Include normalized review IDs, dates, ratings, and text in the Dataset item. Disabled by default to minimize personal data.", "default": 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 } } } } } } } } } }