{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper for Leads, CRM, and Reviews", "description": "Build local prospect lists, enrich CRM contact data, and monitor ratings and reviews from Google Maps. Export business names, phones, websites, ratings, and addresses.", "version": "0.3", "x-build-id": "C8vfrMK5GL0otRqyq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-google-maps-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/lentic_clockss~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-google-maps-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/lentic_clockss~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-google-maps-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", "required": [ "searchQuery" ], "properties": { "runMode": { "title": "Run mode", "enum": [ "real", "fixture" ], "type": "string", "description": "Use real for live Google Maps. fixture is for deterministic smoke tests only.", "default": "real" }, "searchQuery": { "title": "Search query", "minLength": 1, "maxLength": 500, "type": "string", "description": "What to search on Google Maps in the supported US market (e.g. 'coffee in Chicago' or 'hotels near Central Park').", "default": "coffee in Chicago" }, "maxResults": { "title": "Max rows per search query", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum Dataset rows collected for this search query. Default 70. Larger numbers are collected in parts of 70. Places and reviews all count together. The run stops at your maximum total charge. Free Apify plan: 200 rows per run and 10 runs.", "default": 70 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Whether to scrape customer reviews for each place. Useful for outreach context and review monitoring.", "default": false }, "maxReviewsPerPlace": { "title": "Max reviews per place", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum reviews per place, newest first (0 = as many as Google gives, up to 500). Reviews also feed the recent-review monitoring flags.", "default": 0 }, "language": { "title": "Language", "minLength": 2, "maxLength": 8, "type": "string", "description": "Google language code for results, e.g. en, es, es-419, zh-TW. The market is fixed to the United States.", "default": "en" }, "country": { "title": "Market country", "enum": [ "US" ], "type": "string", "description": "Production is intentionally fixed to the United States.", "default": "US" }, "gridBbox": { "title": "Grid bounding box (optional)", "type": "string", "description": "US bounding box 'min_lat,min_lng,max_lat,max_lng'. The box is split into cells (at most 100) and each is searched; only places inside the box are returned. Leave the city out of the search query in this mode.", "default": "" }, "gridCellSizeKm": { "title": "Grid cell size (km)", "minimum": 0.1, "maximum": 10, "type": "number", "description": "Grid cell size in kilometers (grows on its own so the box needs at most 100 cells). Only used when gridBbox is set.", "default": 1 } } }, "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 } } } } } } } } } }