{ "openapi": "3.0.1", "info": { "title": "Google Maps Reviews Scraper", "description": "Scrape full Google Maps reviews from any business by URL, place ID, or CID. Filter by rating, date, and keyword. Skip already-collected review IDs for incremental runs.", "version": "0.0", "x-build-id": "8kUtebYqjdiv08PoF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lurkapi~google-maps-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lurkapi-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/lurkapi~google-maps-reviews-scraper/runs": { "post": { "operationId": "runs-sync-lurkapi-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/lurkapi~google-maps-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-lurkapi-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": "Google Maps URLs", "type": "array", "description": "Paste Google Maps URLs to the businesses you want to scrape reviews for. Long URLs (google.com/maps/place/...), share links (maps.app.goo.gl/...), and place URLs all work.", "items": { "type": "string" } }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Google place IDs (e.g. ChIJD7fiBh9u5kcRYJSMaMOCCwQ). Faster than parsing URLs.", "items": { "type": "string" } }, "cids": { "title": "CIDs", "type": "array", "description": "Numeric Google CIDs (the long number after cid= in old-style URLs). Each one resolves to a single business.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries ($)", "type": "array", "description": "Google Maps text search queries (e.g. 'coffee shops in Seattle'). Each query is resolved to up to Max places per query businesses, and reviews are scraped for each. Adds $5.00 per 1,000 places found.", "items": { "type": "string" } }, "maxPlacesPerQuery": { "title": "Max places per query", "minimum": 1, "maximum": 120, "type": "integer", "description": "How many businesses to scrape per search query. Google caps results at ~120 per query.", "default": 10 }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 0, "type": "integer", "description": "Cap how many reviews are returned per business. Use 0 to fetch all available reviews. Google itself caps at roughly 4,000 to 5,000 reviews per place even for very busy listings.", "default": 1000 }, "sortBy": { "title": "Sort reviews by", "enum": [ "newest", "mostRelevant", "highestRating", "lowestRating" ], "type": "string", "description": "How Google should order the reviews. Newest is required if you set a Reviews start date below.", "default": "newest" }, "reviewsStartDate": { "title": "Reviews start date (only newer than)", "type": "string", "description": "Skip reviews older than this date. Only works when Sort by is set to Newest first (Google does not support server-side date filtering for other sorts)." }, "language": { "title": "Language", "type": "string", "description": "Google interface language (two-letter code, e.g. en, fr, es). Affects auto-translation of review text.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google region (two-letter country code, e.g. US, FR, ES).", "default": "US" }, "minRating": { "title": "Minimum rating (1-5)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop reviews below this star rating." }, "maxRating": { "title": "Maximum rating (1-5)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Drop reviews above this star rating." }, "includeKeyword": { "title": "Include keyword ($)", "type": "string", "description": "Only reviews whose text matches this keyword are returned. Adds $0.10 per 1,000 reviews returned." }, "onlyWithText": { "title": "Only reviews with text", "type": "boolean", "description": "Drop star-only reviews that have no written comment.", "default": false }, "onlyWithOwnerReply": { "title": "Only reviews with an owner reply ($)", "type": "boolean", "description": "Drop reviews that have no owner reply. Adds $0.10 per 1,000 reviews returned.", "default": false }, "excludeReviewIds": { "title": "Skip review IDs", "type": "array", "description": "Bulk-paste review IDs you've already collected (one per line). They're skipped without charge. Useful for incremental monitoring runs.", "items": { "type": "string" } }, "sinceReviewId": { "title": "Since review ID (resume mode)", "type": "string", "description": "Stop scraping when this review ID is reached. Use the most recent review ID from a previous run to fetch only what's new." }, "outputReviewId": { "title": "Review ID", "type": "boolean", "description": "Google's unique identifier for each review.", "default": true }, "outputReviewUrl": { "title": "Review URL", "type": "boolean", "description": "Direct link to the review on Google Maps.", "default": true }, "outputStars": { "title": "Star rating (1-5)", "type": "boolean", "description": "Number of stars the reviewer gave.", "default": true }, "outputText": { "title": "Review text", "type": "boolean", "description": "The review text in its original language.", "default": true }, "outputTextTranslated": { "title": "Review text (translated)", "type": "boolean", "description": "Google's auto-translation of the review text into your interface language, when available.", "default": true }, "outputOriginalLanguage": { "title": "Original language", "type": "boolean", "description": "Detected language of the review text (BCP-47 code).", "default": true }, "outputTranslatedLanguage": { "title": "Translated language", "type": "boolean", "description": "Language Google translated the review into, when applicable.", "default": true }, "outputPublishedAt": { "title": "Published at (relative)", "type": "boolean", "description": "Human-readable relative date (such as '3 weeks ago').", "default": true }, "outputPublishedAtIso": { "title": "Published at (ISO 8601)", "type": "boolean", "description": "Exact publish date in ISO 8601 format.", "default": true }, "outputLastEditedAtIso": { "title": "Last edited at (ISO 8601)", "type": "boolean", "description": "Last edit date in ISO 8601 format. Equals the publish date when the review was never edited.", "default": true }, "outputReviewerId": { "title": "Reviewer ID", "type": "boolean", "description": "Google's obfuscated user ID for the reviewer.", "default": true }, "outputReviewerName": { "title": "Reviewer name", "type": "boolean", "description": "Display name of the reviewer.", "default": true }, "outputReviewerUrl": { "title": "Reviewer profile URL", "type": "boolean", "description": "Link to the reviewer's contributor page.", "default": true }, "outputReviewerPhotoUrl": { "title": "Reviewer photo URL", "type": "boolean", "description": "Reviewer's profile picture URL.", "default": true }, "outputIsLocalGuide": { "title": "Is Local Guide", "type": "boolean", "description": "True if the reviewer is a Google Local Guide.", "default": true }, "outputReviewerTotalReviews": { "title": "Reviewer total reviews", "type": "boolean", "description": "Total number of reviews this reviewer has posted across Google Maps.", "default": true }, "outputReviewerTotalPhotos": { "title": "Reviewer total photos", "type": "boolean", "description": "Total number of photos this reviewer has uploaded across Google Maps.", "default": true }, "outputOwnerReplyText": { "title": "Owner reply text", "type": "boolean", "description": "Business owner's reply to the review, when present.", "default": true }, "outputOwnerReplyPublishedAtIso": { "title": "Owner reply published at (ISO 8601)", "type": "boolean", "description": "Date the owner reply was published.", "default": true }, "outputReviewImageUrls": { "title": "Review image URLs", "type": "boolean", "description": "Photos the reviewer attached to the review.", "default": true }, "outputReviewDetailedRating": { "title": "Detailed rating (per aspect)", "type": "boolean", "description": "Per-aspect ratings the reviewer set, when applicable (Food / Service / Atmosphere / etc.).", "default": true }, "outputPlaceId": { "title": "Place ID", "type": "boolean", "description": "Google place identifier for the business this review belongs to.", "default": true }, "outputCid": { "title": "CID", "type": "boolean", "description": "Numeric Google CID for the business.", "default": true }, "outputFid": { "title": "Feature ID (FID)", "type": "boolean", "description": "Hex feature ID Google uses internally (e.g. 0x...:0x...).", "default": true }, "outputPlaceName": { "title": "Place name", "type": "boolean", "description": "Display name of the business.", "default": true }, "outputPlaceUrl": { "title": "Place URL", "type": "boolean", "description": "Direct link to the business listing on Google Maps.", "default": true }, "outputPlaceAddress": { "title": "Place address", "type": "boolean", "description": "Full street address of the business.", "default": true }, "outputPlaceRating": { "title": "Place average rating", "type": "boolean", "description": "Average review rating of the business (1 to 5).", "default": true }, "outputPlaceCategory": { "title": "Place primary category", "type": "boolean", "description": "First category Google assigns to the business.", "default": true }, "outputPlaceCategories": { "title": "Place categories (all)", "type": "boolean", "description": "All categories Google assigns to the business.", "default": true }, "outputPlaceLatitude": { "title": "Place latitude", "type": "boolean", "description": "Latitude in decimal degrees.", "default": true }, "outputPlaceLongitude": { "title": "Place longitude", "type": "boolean", "description": "Longitude in decimal degrees.", "default": true }, "outputPlaceWebsite": { "title": "Place website", "type": "boolean", "description": "Business website URL listed on Google Maps.", "default": true }, "outputPlacePhone": { "title": "Place phone", "type": "boolean", "description": "Business phone number listed on Google Maps.", "default": true }, "outputInputUrl": { "title": "Source input", "type": "boolean", "description": "The URL, place ID, or CID from your input that produced this row.", "default": true }, "outputSearchQuery": { "title": "Source search query", "type": "boolean", "description": "Search query that surfaced this place. Empty for places provided directly via URL / place ID / CID.", "default": true }, "outputScrapedAt": { "title": "Scraped at (ISO 8601)", "type": "boolean", "description": "Timestamp this row was scraped.", "default": true }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Proxy used for Google Maps requests. Datacenter is the default for cost efficiency. Switch to Residential if you see frequent blocks.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } }