{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper", "description": "Finds newly opened and fast-growing businesses on Google Maps with review velocity tracking. Captures real customer reviews, enriches data and extracts live hotel/resort rates (min/avg/max) from Booking, Agoda & Expedia etc.", "version": "0.1", "x-build-id": "2fsMEz8AfK4668llM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/badruddeen~google-maps-2026/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-badruddeen-google-maps-2026", "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/badruddeen~google-maps-2026/runs": { "post": { "operationId": "runs-sync-badruddeen-google-maps-2026", "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/badruddeen~google-maps-2026/run-sync": { "post": { "operationId": "run-sync-badruddeen-google-maps-2026", "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", "required": [ "location" ], "properties": { "safeMode": { "title": "Safe Mode (for Apify validation)", "type": "boolean", "description": "When enabled (recommended for automated Apify checks and first runs), feeds dummy data instead of scraping. Turn OFF manually when ready for real monitoring.", "default": true }, "searchQuery": { "title": "Search Query / Category", "type": "string", "description": "Main Google Maps search term. Examples: 'restaurant', 'cafe', 'new restaurant', 'bistro', 'fast food'. For multiple categories, separate with commas (e.g., 'restaurant,cafe,bar').", "default": "hotel" }, "location": { "title": "Location / Area", "type": "string", "description": "City, region, or coordinates (e.g. 'New York, NY', 'London', '40.7128,-74.0060'). This is required. For best coverage, use city-level or metro area names.", "default": "California, San Francisco" }, "maxResults": { "title": "Max Results per Run", "minimum": 2, "maximum": 500, "type": "integer", "description": "Maximum listings to extract and check per execution. Higher values = longer run time + higher platform usage. 100–300 is a good balance for daily monitoring.", "default": 10 }, "newReviewThreshold": { "title": "Newness: Max Reviews Threshold", "minimum": 0, "type": "integer", "description": "Flag a listing as 'potentially new' if it has ≤ this many reviews (new places often have 0–10 reviews). In bigger cities even a new place might have higher reviews even in a single day. Our actor helps improve detection accuracy since Google doesn't provide creation dates by checking maximum reviews limit. Please do note with every record the actor will fetch 15 vreviews.", "default": 10 }, "minRating": { "title": "Minimum Rating Filter (optional)", "type": "number", "description": "Only consider listings with rating ≥ this value (e.g. 3.5). Leave empty to include all (recommended for catching brand-new places with few/no ratings)." } } }, "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 } } } } } } } } } }