{ "openapi": "3.0.1", "info": { "title": "Google Maps Local SEO Grid Scraper", "description": "Local SEO geo-grid for Google Maps: scan a keyword from many GPS points around your center coordinate and get ranked businesses plus Place IDs per cell. Track your GBP rank block by block, export heatmap SVG, and power agency reports via API—without a separate Maps SERP API.", "version": "1.0", "x-build-id": "XUAU06LpmB0be7pFK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rainminer~google-maps-local-seo-grid-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rainminer-google-maps-local-seo-grid-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/rainminer~google-maps-local-seo-grid-scraper/runs": { "post": { "operationId": "runs-sync-rainminer-google-maps-local-seo-grid-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/rainminer~google-maps-local-seo-grid-scraper/run-sync": { "post": { "operationId": "run-sync-rainminer-google-maps-local-seo-grid-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": [ "keyword", "latitude", "longitude" ], "properties": { "keyword": { "title": "Search keyword", "type": "string", "description": "Google Maps search query (e.g. plumber near me, pizza delivery, personal injury lawyer)." }, "latitude": { "title": "Center latitude", "type": "number", "description": "Latitude of the grid center (your business or neighborhood anchor)." }, "longitude": { "title": "Center longitude", "type": "number", "description": "Longitude of the grid center." }, "gridSize": { "title": "Grid size", "minimum": 3, "maximum": 15, "type": "integer", "description": "Number of rows and columns (e.g. 5 = 5×5 = 25 search points).", "default": 5 }, "spacingMeters": { "title": "Spacing (meters)", "minimum": 50, "maximum": 20000, "type": "integer", "description": "Distance between adjacent grid points in meters.", "default": 500 }, "zoom": { "title": "Maps zoom (optional)", "minimum": 3, "maximum": 21, "type": "integer", "description": "Override automatic zoom derived from grid size and spacing. Leave empty to auto-calculate." }, "maxItems": { "title": "Max listings per grid point", "minimum": 1, "maximum": 120, "type": "integer", "description": "Maximum ranked businesses returned for each coordinate (up to 120).", "default": 20 }, "trackPlaceId": { "title": "Tracked Place ID", "type": "string", "description": "Optional Google Place ID (ChIJ…) of your business to compute trackedRank on each grid cell." }, "trackBusinessName": { "title": "Tracked business name", "type": "string", "description": "Fallback name match when Place ID is missing or not found in results." }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many grid points to query in parallel.", "default": 5 }, "language": { "title": "Language", "type": "string", "description": "Maps UI language code (e.g. en, de).", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use proxies if Google blocks datacenter IPs in your region.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }