{ "openapi": "3.0.1", "info": { "title": "Google Maps Business Scraper & Monitor: Leads by Category", "description": "List businesses from Google Maps by category and location: name, category, rating, reviews count, address, website, opening status and coordinates. Changes mode returns only new places, closures and rating moves. Phone optional. No login, no reviews.", "version": "0.1", "x-build-id": "31RvFoi5M6i0juVE7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nswk_api~google-maps-business-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nswk_api-google-maps-business-monitor", "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/nswk_api~google-maps-business-monitor/runs": { "post": { "operationId": "runs-sync-nswk_api-google-maps-business-monitor", "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/nswk_api~google-maps-business-monitor/run-sync": { "post": { "operationId": "run-sync-nswk_api-google-maps-business-monitor", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to look for, e.g. \"dentist\", \"hardware store\", \"vegan restaurant\". Each term is searched in each location.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Where to look, e.g. \"Austin, Texas\" or \"Temuco, Chile\". Leave empty if your search terms already include the place.", "items": { "type": "string" } }, "queries": { "title": "Full queries", "type": "array", "description": "Optional. Queries exactly as you would type them in Google Maps, e.g. \"coffee shops in Lima\". Added to the term × location searches.", "items": { "type": "string" } }, "maxPlacesPerSearch": { "title": "Max places per search", "minimum": 1, "maximum": 120, "type": "integer", "description": "Google's list ends at about 120 places per search. Split big cities into neighborhoods to get more.", "default": 60 }, "mode": { "title": "Mode", "enum": [ "all", "changes" ], "type": "string", "description": "\"all\" returns every place. \"changes\" returns only places that are new, updated (closed, new website, rating move...) or missing since the last run with the same monitor ID. Schedule it weekly.", "default": "all" }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of the saved state for changes mode. By default it is derived from your searches and filters." }, "includePhone": { "title": "Include business phone", "type": "boolean", "description": "Add the phone number shown on the business listing. Off by default. Some small businesses list a personal mobile number: only use phones in line with the privacy and marketing laws that apply to you.", "default": false }, "includeDetails": { "title": "Open each place page (details)", "type": "boolean", "description": "Also read each place's own page: full address with postal code, website, phone, plus code and weekly opening hours. The list alone shows the website only for some categories. Charged per place page read. Turned on automatically when you filter by website.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep places rated at least this much (0 to 5)." }, "minReviews": { "title": "Minimum reviews count", "minimum": 0, "type": "integer", "description": "Keep places with at least this many reviews." }, "website": { "title": "Website", "enum": [ "any", "with", "without" ], "type": "string", "description": "\"without\" finds businesses with no website, a classic lead list for web agencies. This filter reads each place page, so it turns on details.", "default": "any" }, "categories": { "title": "Categories", "type": "array", "description": "Keep places whose Google category contains any of these, e.g. \"dental clinic\". Case-insensitive.", "items": { "type": "string" } }, "excludeClosed": { "title": "Skip permanently closed", "type": "boolean", "description": "Drop places marked permanently closed. In changes mode a known place that closes is still reported.", "default": true }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 3, "type": "integer", "description": "Search pages loaded at once (1 to 3).", "default": 2 } } }, "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 } } } } } } } } } }