{ "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper ($0.01 / 1,000 reviews)", "description": "Scrape all Google Maps reviews for $0.01 per 1,000: text, rating, exact date, photos, reviewer and place details. Use place names, links, place IDs or cids, or search by keyword and city. Filter by stars, keyword or date.", "version": "0.1", "x-build-id": "wHTadjGZiPUr6Z5Fu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serpdata~google-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serpdata-google-maps-reviews-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/serpdata~google-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-serpdata-google-maps-reviews-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/serpdata~google-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-serpdata-google-maps-reviews-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": { "places": { "title": "Places", "type": "array", "description": "One place per line: a business name with its city (\"Jo's Coffee, Austin TX\"), a Google Maps link (including maps.app.goo.gl share links), a Google place ID (ChIJ…), a feature ID (0x…:0x…), or a Google cid.", "items": { "type": "string" } }, "maxReviewsPerPlace": { "title": "Reviews per place", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most reviews to return for each place. Places with fewer reviews return all of them.", "default": 100 }, "sort": { "title": "Sort reviews by", "enum": [ "relevant", "newest", "highest", "lowest" ], "type": "string", "description": "The order Google returns reviews in. Newest first makes date filters fastest. When a date filter is set and this is left empty, reviews are sorted newest first." }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code, such as de. Reviews written in other languages come back with a translation into this language.", "default": "en" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Find places by searching Google Maps, such as \"dentist\" or \"pizza\", and get reviews for each place found. No links needed.", "items": { "type": "string" } }, "searchLocation": { "title": "Search location", "type": "string", "description": "Where to search, such as \"Leeds, UK\" or \"Austin, TX\"." }, "maxPlacesPerSearch": { "title": "Places per search query", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many places to take from each search, up to 200.", "default": 10 }, "starRatings": { "title": "Star ratings", "type": "array", "description": "Only return reviews with these star ratings. Leave empty for all ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "keyword": { "title": "Keyword", "type": "string", "description": "Only return reviews whose text contains this word or phrase. Not case-sensitive." }, "reviewsNewerThan": { "title": "Reviews from", "type": "string", "description": "Only return reviews posted on or after this date." }, "reviewsOlderThan": { "title": "Reviews until", "type": "string", "description": "Only return reviews posted on or before this date." }, "includePersonalData": { "title": "Include reviewer details", "type": "boolean", "description": "Include each reviewer's name, ID and photo. Turn this off if you do not need personal data. In the EU it is protected by the GDPR, so only collect it when you have a lawful reason to.", "default": true } } }, "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 } } } } } } } } } }