{ "openapi": "3.0.1", "info": { "title": "Google Maps Rank Tracker — Local SEO Positions & Reviews", "description": "Track where your business ranks on Google Maps for every keyword and city, daily, with rank changes and review growth - not just a list of places. Give keywords, locations and the businesses to watch; get position, change since the last run and review count. $5 per 1,000 results. No login.", "version": "0.1", "x-build-id": "weKfGUeF0kN1PSgsp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~google-maps-rank-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-google-maps-rank-tracker", "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/northbell~google-maps-rank-tracker/runs": { "post": { "operationId": "runs-sync-northbell-google-maps-rank-tracker", "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/northbell~google-maps-rank-tracker/run-sync": { "post": { "operationId": "run-sync-northbell-google-maps-rank-tracker", "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": [ "watch" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "What people search for, one per line: \"dentist\", \"emergency dentist\", \"ramen\". Every keyword is searched in every location below as \"keyword in location\".", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities or areas, one per line: \"Austin, TX\", \"Round Rock, TX\", \"Manchester, UK\". Google ranks by the place named in the search, so write the location the way you would type it into Google Maps.", "items": { "type": "string" } }, "watch": { "title": "Businesses to track (required)", "type": "array", "description": "Required. The businesses whose position you want, one per line (up to 25): a website address (best for a business with one site), the business name, a Google Maps place link (best for one location of a chain), or a place ID (ChIJ... or 0x...:0x...). Each one is matched against every result and gets one row per keyword and location. The Actor outputs only these businesses, not the list of places it reads, so the run fails without at least one.", "items": { "type": "string" } }, "searches": { "title": "Free-text searches (optional)", "type": "array", "description": "Extra searches written exactly as you would type them into Google Maps, with the area in them: \"dentist in Manchester, UK\". Use this instead of, or next to, keywords and locations. Changes since the last run are kept per search text, so keep the wording the same from run to run.", "items": { "type": "string" } }, "maxPlacesPerSearch": { "title": "How deep to look", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many places to read for each search, in the order Google lists them (1 to 200). A business below this position is reported as not found. Reading deeper costs nothing extra: you pay per tracked result, not per place read.", "default": 60 }, "topResults": { "title": "Top places to show", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many of the top places to name on each row, with their position and how they moved since the last run (0 to 20; 0 turns it off). Names and positions only - no addresses, phones or hours. Shown also when your business is not found, so you see who holds the top spots.", "default": 5 }, "language": { "title": "Language", "type": "string", "description": "Language code for categories, weekday names and opening hours, e.g. en, de, ja, fr, es, pt-BR, zh-CN. It can also change which places rank where, so keep the same language from run to run: changes since the last run are compared per language.", "default": "en" } } }, "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 } } } } } } } } } }