{ "openapi": "3.0.1", "info": { "title": "Maps Reviews Fast", "description": "Extract Google Maps reviews at scale affordably ($0.25/1k). Get texts, stars, reviewer data, translations, owner responses, and photos. Features a unique \"Deep Search\" mode to bypass Google's pagination limits and scrape the absolute maximum number of reviews per place.", "version": "0.0", "x-build-id": "meEsIhh8Mt4OsCPkg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/knowten~maps-reviews-fast/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-knowten-maps-reviews-fast", "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/knowten~maps-reviews-fast/runs": { "post": { "operationId": "runs-sync-knowten-maps-reviews-fast", "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/knowten~maps-reviews-fast/run-sync": { "post": { "operationId": "run-sync-knowten-maps-reviews-fast", "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": { "startUrls": { "title": "Google Maps place URLs", "type": "array", "description": "Google Maps place URLs. Supported: place links (/maps/place/...), review links, ?cid= links, search links (/maps/search/, the top result is used) and maps.app.goo.gl short links.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Google Place IDs (e.g. ChIJVVVVVVXlUVMRu-GPNDD5qKw).", "items": { "type": "string" } }, "maxReviews": { "title": "Number of reviews", "minimum": 1, "type": "integer", "description": "Maximum number of reviews per place. Leave the default to scrape every review Google lists.", "default": 10000000 }, "reviewsSort": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "highestRanking", "lowestRanking" ], "type": "string", "description": "Order in which Google returns the reviews. \"Newest\" goes deepest and allows stopping early with a start date.", "default": "newest" }, "deepSearch": { "title": "Deep search", "type": "boolean", "description": "When the chosen sort order runs out before \"Number of reviews\" is reached, continue with the other sort orders and merge the results (duplicates removed). Useful for places with tens of thousands of reviews.", "default": false }, "reviewsStartDate": { "title": "Only scrape reviews newer than [date]", "type": "string", "description": "Only reviews published after this date. Absolute (2024-05-03) or relative (8 days, 3 months, 1 year). With \"Newest\" sorting the scraper stops as soon as it reaches older reviews." }, "outputPlaceWhenEmpty": { "title": "Output the place when no review is in range", "type": "boolean", "description": "For monitoring runs with a start date: when a place has no new review, output one row with the place data (rating, review count) and every review field empty (placeOnly = true), so a quiet day still records the place's numbers.", "default": false }, "language": { "title": "Language", "enum": [ "en", "af", "az", "id", "ms", "bs", "ca", "cs", "da", "de", "et", "es", "es-419", "eu", "fil", "fr", "gl", "hr", "zu", "is", "it", "sw", "lv", "lt", "hu", "nl", "no", "uz", "pl", "pt-BR", "pt-PT", "ro", "sq", "sk", "sl", "fi", "sv", "vi", "tr", "el", "bg", "ky", "kk", "mk", "mn", "ru", "sr", "uk", "ka", "hy", "iw", "ur", "ar", "fa", "am", "ne", "hi", "mr", "bn", "pa", "gu", "ta", "te", "kn", "ml", "si", "th", "lo", "my", "km", "ko", "ja", "zh-CN", "zh-TW" ], "type": "string", "description": "Language of the output. Reviews written in another language also get a Google translation in \"textTranslated\".", "default": "en" }, "reviewsOrigin": { "title": "Reviews origin", "enum": [ "all", "google" ], "type": "string", "description": "\"Google\" keeps only reviews written on Google (drops partner reviews such as hotel booking sites).", "default": "all" }, "personalData": { "title": "Extract personal data", "type": "boolean", "description": "Include reviewer name, ID, profile URL and photo. Disable to comply with stricter privacy requirements.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests go directly to Google; the proxy is only used as a fallback while Google throttles direct connections.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Places scraped in parallel. Leave empty to size it automatically from the run memory (about 1 per 50 MB)." } } }, "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 } } } } } } } } } }