{ "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper $0.25šŸ’° Search + Owner Replies", "description": "Extract Google Maps reviews from $0.25/1K ā€” by text search (\"dentists in Austin TX\"), place URL, Place ID, CID or FID. Owner replies, likes, review language + original text, trip details, star/keyword/date filters, GDPR mode. Export JSON/CSV, run via API, schedule or integrate.", "version": "0.0", "x-build-id": "zZJEm7oFRQd5j41w7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~google-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~google-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~google-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "URLs to start with. Supports Google Maps place URLs (https://www.google.com/maps/place/...), review detail URLs (https://www.google.com/maps/reviews/...), shortened mobile links (https://maps.app.goo.gl/...), Maps search URLs with query_place_id, and Google Search result URLs that include the reviews panel fragment (https://www.google.com/search?q=...#lrd=0x...:0x...,1,,,,).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "placeIds": { "title": "Google Place IDs", "type": "array", "description": "Array of Google Place IDs to scrape reviews for. Each Place ID should be a string like 'ChIJrTLr-GyuEmsRBfyf1GD_LAY'.", "items": { "type": "string" } }, "FIDs": { "title": "Google Feature IDs", "type": "array", "description": "Array of Google Feature IDs to scrape reviews for. Each Feature ID should be a string like '0x89c25966dcad44b7:0x5cb022a289de6b19'.", "items": { "type": "string" } }, "CIDs": { "title": "Google CIDs", "type": "array", "description": "Array of Google CIDs to scrape reviews for. Each CID should be a string like '15792901685599310349'.", "items": { "type": "string" } }, "searchQueries": { "title": "šŸ†• Search queries", "type": "array", "description": "Scrape reviews for every place matching a text search ā€” e.g. `dentists in Austin TX`, `hotels in Kastoria`, `vegan restaurants Berlin`. Include the city/area in the query. Each query is capped by \"Max places per search query\" below. Combine freely with Start URLs / place IDs.", "items": { "type": "string" } }, "maxPlacesPerQuery": { "title": "Max places per search query", "minimum": 1, "maximum": 60, "type": "integer", "description": "Cap on how many matching places each search query expands to (1-60). The global \"Number of reviews\" cap still applies across all places.", "default": 20 }, "searchCoordinates": { "title": "Search coordinates (lat,lng)", "type": "string", "description": "Optional viewport bias for Search queries that do not name a place, e.g. `40.7128,-74.0060` to run `coffee shops` around New York. Queries that include a city (\"dentists in Austin TX\") do not need this." }, "sort": { "title": "Sort Reviews By", "enum": [ "mostRelevant", "newest", "highestRating", "lowestRating" ], "type": "string", "description": "Define how reviews should be sorted.", "default": "newest" }, "language": { "title": "Language", "type": "string", "description": "Language code for the reviews (e.g., 'en', 'de', 'es', 'fr').", "default": "en" }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code passed to Google as the `gl` parameter ā€” biases result ranking and regional variants (e.g. `US`, `GB`, `DE`, `GR`). Default `US`.", "default": "US" }, "dateNewerThan": { "title": "Only scrape reviews newer than", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$", "type": "string", "description": "Either absolute date (e.g. 2024-05-03) or relative date from now into the past (e.g. 8 days, 3 months). JSON input also supports adding time in both absolute (ISO standard, e.g. 2024-05-03T20:00:00) and relative (e.g. 3 hours) formats. Absolute time is always interpreted in the UTC timezone, not your local timezone - please convert accordingly. Supported relative date & time units: minutes, hours, days, weeks, months, years.\n\nāš ļø Heads up: If this parameter is specified, you must choose the 'Newest' sort by value. The reason for this is that with this parameter entered, the actor stops scraping reviews as soon as it finds the first review that's older than the specified date. If the sorting is not set to 'Newest', it might encounter a review older than the specified date before it reaches the desired review count and not scrape the desired amount of reviews." }, "dateOlderThan": { "title": "Only scrape reviews older than [date]", "type": "string", "description": "Upper date bound ā€” only reviews posted ON or BEFORE this date. Combine with \"Only scrape reviews newer than\" for an exact date window. Formats: `YYYY-MM-DD` or relative like `3 months`." }, "filterKeyword": { "title": "Filter reviews by keyword", "type": "string", "description": "Only keep reviews whose text (including original-language text and the owner's response) contains this keyword, case-insensitive. E.g. `breakfast`, `parking`, `rude`." }, "filterStars": { "title": "Filter by star rating", "type": "array", "description": "Only keep reviews with these star ratings. E.g. pick `1` and `2` to mine complaints, or `5` for testimonials. 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" ] } }, "reviewsOrigin": { "title": "Reviews origin", "enum": [ "all", "google" ], "type": "string", "description": "Google aggregates some reviews from third-party platforms. `google` keeps only native Google reviews; `all` (default) keeps everything. Each row carries a `review_origin` field either way.", "default": "all" }, "personalData": { "title": "Include reviewer personal data", "type": "boolean", "description": "When OFF, reviewer-identifying fields (name, profile URL, photo, reviewer id) are redacted from the output ā€” useful for GDPR-sensitive pipelines. Review text and ratings are kept.", "default": true }, "includePlaceDetails": { "title": "Include place details on each row", "type": "boolean", "description": "Adds the place's overall rating, categories, coordinates, full address and canonical name to every review row (`place_rating`, `place_categories`, `place_latitude`/`place_longitude`, `place_address`, `placeName`). Costs 2 extra requests per place.", "default": false }, "translateTo": { "title": "Translate reviews to [language]", "type": "string", "description": "Language code like `en`, `de`, `es`. Reviews written in another language get `review_text_translated` + `review_language_translated` filled via Google Translate. Leave empty for no translation." }, "maxItems": { "title": "Number of reviews", "type": "integer", "description": "Maximum number of reviews to scrape per run", "default": 100 }, "maxConcurrency": { "title": "Max Concurrency", "type": "integer", "description": "Maximum number of pages that can be processed at the same time.", "default": 100 }, "minConcurrency": { "title": "Min Concurrency", "type": "integer", "description": "Minimum number of pages that will be processed at the same time.", "default": 1 }, "maxRequestRetries": { "title": "Max Request Retries", "type": "integer", "description": "Number of times the crawler will retry a failed request before giving up.", "default": 100 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.

For details, see Proxy configuration in README.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }