{ "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper - $0.27 per 1,000 Reviews", "description": "$0.27 per 1,000 reviews, the cheapest Google Maps reviews scraper on the market. Star rating, full text, exact date, reviewer with lifetime review count, owner reply and photos, from a place link, place ID, CID or business name. No API key, no quota, no five-review cap.", "version": "0.1", "x-build-id": "EiIe5q9GnpRYxpgt1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~google-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~google-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~google-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "placeUrls": { "title": "Place links or IDs", "minItems": 0, "maxItems": 50, "type": "array", "description": "Google Maps place links (https://www.google.com/maps/place/... or a maps.app.goo.gl short link), place IDs (ChIJ...), or numeric CIDs. Up to 50 per run. Copy the link straight from the address bar - all the extra junk in it is ignored.", "items": { "type": "string" } }, "searchTerms": { "title": "Business names to look up", "minItems": 0, "maxItems": 50, "type": "array", "description": "Business names to find on Google Maps first, e.g. \"Katz's Delicatessen New York\". The top matching place is used. Include the town or city - a bare \"Starbucks\" can match anywhere in the world.", "items": { "type": "string" } }, "maxReviews": { "title": "Maximum reviews", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Total reviews to return across every place in this run. The budget is shared evenly between the places, so five places and 100 reviews gives you twenty of each. Hard ceiling 5,000. Keep it low while testing - you pay per review." }, "maxReviewsPerPlace": { "title": "Maximum reviews per place", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Optional cap for a single place, on top of the total above. Useful when one place has 50,000 reviews and you only want the latest 100 from each." }, "sort": { "title": "Review order", "enum": [ "newest", "relevant", "highest", "lowest" ], "type": "string", "description": "Which reviews Google hands over first. Newest is the right choice for monitoring; Most relevant returns the longer, photo-heavy reviews Google promotes." }, "reviewsSince": { "title": "Only reviews since", "type": "string", "description": "Optional cutoff. Either a date like 2026-01-01 or a window like \"30 days\". With Newest first the run stops paging a place as soon as it is past the cutoff, so a daily monitor costs a couple of requests instead of a full history pull." }, "onlyWithText": { "title": "Skip star-only ratings", "type": "boolean", "description": "Google counts a bare star rating with no words as a review. Turn this on to drop those, so you only pay for reviews that actually say something." }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code for the reviews, e.g. en, de, fr, es. Reviews written in another language come back translated, with the writer's original wording kept in originalText." }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code for the Google edition to read, e.g. us, gb, de. Mostly affects how dates and place names are written." }, "proxyUrls": { "title": "Your own proxy servers (optional)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Leave this empty. By default the run rotates a large pool of addresses that cost you nothing per gigabyte. Fill it in only if you specifically want the traffic to leave through proxy servers you already pay for, in the form http://user:pass@host:port.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }