{ "openapi": "3.0.1", "info": { "title": "Google Maps Monitor — Only What Changed Since Your Last Run", "description": "Watch a Google Maps territory and get back only what is new or changed — rating moves, review growth, new businesses, renames, relocations, hours and contact changes — with the previous values attached. Unchanged businesses are re-checked free and never billed.", "version": "0.1", "x-build-id": "39QxoafweWv69Eif9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/godberry~google-maps-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-godberry-google-maps-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/godberry~google-maps-monitor/runs": { "post": { "operationId": "runs-sync-godberry-google-maps-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/godberry~google-maps-monitor/run-sync": { "post": { "operationId": "run-sync-godberry-google-maps-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": "Searches to watch", "type": "array", "description": "One per line — the territory you want monitored. Use natural Google Maps searches: \"restaurants in Berlin\", \"dentists, Austin TX\", \"plumbers near Manchester\". Keep the SAME searches between runs: the monitor compares each run against the last one, so changing the searches changes what it is watching.", "items": { "type": "string" } }, "monitorId": { "title": "Monitor name", "type": "string", "description": "Names this watchlist so its memory is kept separate from your others. Use one name per territory — e.g. 'berlin-restaurants' and 'lisbon-cafes' are tracked independently. Reuse the same name every run: that is what lets the Actor know what it already showed you. Changing it starts a fresh baseline.", "default": "default" }, "maxCostUsd": { "title": "Hard cost cap for this run (USD)", "type": "string", "description": "A ceiling in DOLLARS, not in rows. The run stops delivering once it would exceed this, and anything held back is offered again on your next run rather than being silently dropped. Leave empty for no cap. This protects you from a surprise bill when a territory changes far more than usual." }, "maxResultsPerSearch": { "title": "Max businesses to check per search", "minimum": 1, "maximum": 120, "type": "integer", "description": "How deep to scan each search (1–120; Google caps a single Maps search at ~120). This is how many businesses are CHECKED. Businesses that are identical to last run cost $0.0002 each to re-check — real money is only charged for the ones that are new or changed.", "default": 50 }, "language": { "title": "Language", "type": "string", "description": "UI language code (e.g. 'en', 'de', 'fr'). Keep it consistent between runs — switching languages can change how names and hours are written, which reads as a change.", "default": "en" }, "countryCode": { "title": "Country", "type": "string", "description": "Two-letter geo-bias country code (e.g. 'us', 'de', 'gb'). Match it to the territory you are watching.", "default": "us" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Defaults to Apify's datacenter proxy pool, which is included on paid plans and costs you nothing per gigabyte. We tested this: datacenter succeeded on 5 of 5 territories (Berlin, Austin, Manchester, Rome, Sydney) and returned identical results to residential at about a fifth of the cost. Switch on Residential only if a specific territory starts getting blocked — it is billed per GB.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }