{ "openapi": "3.0.1", "info": { "title": "Google Maps Category Scraper", "description": "Scrape ranked businesses from Google Maps category pills (Restaurants, Hotels, Museums, and more) for any map viewport. Export rank, Place IDs, ratings, addresses, and images—ideal for local SEO, category visibility audits, and competitor monitoring. No login required.", "version": "1.0", "x-build-id": "SGNUCdEnZ0S8il3Me" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rainminer~google-maps-category-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rainminer-google-maps-category-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-category-scraper/runs": { "post": { "operationId": "runs-sync-rainminer-google-maps-category-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-category-scraper/run-sync": { "post": { "operationId": "run-sync-rainminer-google-maps-category-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", "properties": { "startUrls": { "title": "Category search URLs", "type": "array", "description": "Optional. Copy from Google Maps after clicking a category pill: /maps/search//@latitude,longitude,zoom", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categories": { "title": "Categories", "type": "array", "description": "Google Maps category pills to scrape for the map center below. Select one or more.", "items": { "type": "string", "enum": [ "Restaurants", "Hotels", "Things to do", "Museums", "Transit", "Pharmacies", "ATMs", "Gas stations", "Groceries", "Coffee", "Bars", "Shopping", "Parking", "Hospitals", "Banks", "Gyms", "Beauty salons", "Car rental", "EV charging", "Libraries", "Schools", "Post offices" ], "enumTitles": [ "Restaurants", "Hotels", "Things to do", "Museums", "Transit", "Pharmacies", "ATMs", "Gas stations", "Groceries", "Coffee", "Bars", "Shopping", "Parking", "Hospitals", "Banks", "Gyms", "Beauty salons", "Car rental", "EV charging", "Libraries", "Schools", "Post offices" ] }, "default": [ "Restaurants" ] }, "latitude": { "title": "Map center latitude", "type": "number", "description": "Latitude from the Maps URL (@lat,lng,zoom). Required when using categories." }, "longitude": { "title": "Map center longitude", "type": "number", "description": "Longitude from the Maps URL. Required when using categories." }, "zoom": { "title": "Map zoom", "minimum": 3, "maximum": 21, "type": "integer", "description": "Zoom level from the Maps URL (the number before z, e.g. 15z).", "default": 15 }, "maxItems": { "title": "Max listings per search", "minimum": 1, "maximum": 120, "type": "integer", "description": "Maximum ranked places to return per category/area (up to 120).", "default": 5 }, "trackPlaceIds": { "title": "Tracked place IDs", "type": "array", "description": "Optional Google Place IDs (ChIJ…) to flag in results and log their category rank when they appear in the listing.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Maps UI language code (e.g. en, de, bg).", "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 } } } } } } } } } }