{ "openapi": "3.0.1", "info": { "title": "Google Maps New Business & Competitor Openings Monitor", "description": "Runs a Google Maps place search for an area and business category and emits only the listings that are new since the previous run, so you get an alert-style feed of new openings instead of a full re-download every time.", "version": "1.0", "x-build-id": "YwJUuVRIFaCeKsCPU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mibedk~google-maps-new-openings-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mibedk-google-maps-new-openings-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/mibedk~google-maps-new-openings-monitor/runs": { "post": { "operationId": "runs-sync-mibedk-google-maps-new-openings-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/mibedk~google-maps-new-openings-monitor/run-sync": { "post": { "operationId": "run-sync-mibedk-google-maps-new-openings-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "minItems": 1, "type": "array", "description": "One entry per area+category combination you want monitored, written exactly as you would type it into the Google Maps search box (e.g. \"coffee shop in Austin, TX\" or \"hair salon near 10001\"). Each query is tracked separately, so you can watch several categories or cities in one run.", "default": [ "coffee shop in Austin, TX" ], "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max listings to scan per query", "minimum": 1, "maximum": 120, "type": "integer", "description": "How many listings to pull from the Google Maps results feed for each search query before comparing against the previous run. Google Maps rarely returns more than ~120 results for one search. A lower number keeps runs fast and cheap; it does not limit how many *new* listings can be reported.", "default": 60 }, "enrichNewListings": { "title": "Fetch phone/website for new listings", "type": "boolean", "description": "When a listing is newly detected, open its Google Maps place page to also capture phone number, website and total review count. This adds one extra page load per new listing only (not per scanned listing), so it stays cheap on runs where nothing new opened.", "default": true }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Name of the key-value store used to remember which listings were already seen, so future runs can detect what's new. Leave this at the default so scheduled runs of this Actor keep comparing against the same history. Only change it if you are running two independent monitors from the same Apify account and want them to keep separate history.", "default": "google-maps-new-openings-monitor-state" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Google Maps works without a proxy for light, occasional use, but will start showing consent/CAPTCHA pages if you run many queries from the same IP in a short time. Enable Apify Proxy (residential recommended) if you monitor more than a handful of queries or run on a tight schedule.", "default": { "useApifyProxy": false } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of search queries processed in parallel. Kept low by default because each query drives a real browser page; raising it speeds up multi-query runs but increases the chance Google shows a CAPTCHA.", "default": 2 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 30, "maximum": 300, "type": "integer", "description": "How long to wait for a single Google Maps page (search or place detail) to load before it counts as a failed attempt and is retried.", "default": 90 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "How many times to retry a search or place-detail page after a failed load (timeout, block page, network error) before giving up on it.", "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 } } }, "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 } } } } } } } } } }