{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper — Business Leads & Places API | $0.60/1k", "description": "Scrape Google Maps places by keyword + location or by URL, place ID or CID: name, category, address, lat/lng, phone, website, rating, review count, hours.", "version": "0.1", "x-build-id": "RJpqyffBSNYB77cwu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/glasswing~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-glasswing-google-maps-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/glasswing~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-glasswing-google-maps-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/glasswing~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-glasswing-google-maps-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": { "searchStringsArray": { "title": "Search terms", "type": "array", "description": "What to look for on Google Maps, one term per line, e.g. \"dentist\", \"coffee shop\", \"hvac contractor\". Each term is searched in the Location below (\"dentist in Austin, TX\"). You can also type the place into the term itself (\"pizza near Times Square\") and leave Location empty.", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "City, region, postcode or address the search terms are run in, e.g. \"Austin, TX\", \"Berlin\", \"SW1A 1AA\". Leave empty when the search terms already say where." }, "maxItems": { "title": "Maximum places (whole run)", "minimum": 1, "type": "integer", "description": "Stop after this many places have been saved, across all searches. Each saved place with status `ok` is one billable result; duplicates across searches are removed and never billed. Leave empty to get up to \"Maximum places per search\" for every search (200 per search when that is empty too), plus one row per place ID or place URL.", "default": null }, "maxCrawledPlacesPerSearch": { "title": "Maximum places per search", "minimum": 1, "type": "integer", "description": "Optional cap for each search term. Google lists about 120-160 places for one search; turn on the deeper scan below to go past that. Leave empty for no per-search cap (when Maximum places is empty too, each search stops at 200 places)." }, "deeperCityScrape": { "title": "Deeper scan of the whole area", "type": "boolean", "description": "When a search hits Google's ~120-place limit, split the area into smaller map tiles and search each one, to find many more places in a big city. Only places inside the searched area are kept. Uses more requests, but you pay only per saved place. With both place limits empty, a search stops at 200 places; set Maximum places (or Maximum places per search) higher to collect more.", "default": false }, "startUrls": { "title": "Google Maps URLs", "uniqueItems": true, "type": "array", "description": "Optional. Google Maps search URLs (https://www.google.com/maps/search/plumber+in+Denver/@39.73,-104.99,12z), place URLs (https://www.google.com/maps/place/...), ?cid= links or maps.app.goo.gl short links. A search URL keeps its map position.", "default": [ "https://www.google.com/maps/search/coffee+shop+in+Austin,+TX" ], "items": { "type": "string" } }, "placeIds": { "title": "Place IDs or CIDs", "type": "array", "description": "Optional. Google place IDs (ChIJ...) or numeric CIDs to look up directly, one per line. Returns one row per place.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Language of category names, opening-hours text and addresses (Google's hl code), e.g. en, de, fr, es, pt-BR.", "default": "en" }, "countryCode": { "title": "Country (region bias)", "type": "string", "description": "Two-letter country code Google uses to interpret the search (gl), e.g. us, gb, de. Set it to the country you search in when a city name exists in several countries.", "default": "us" }, "skipClosedPlaces": { "title": "Skip closed places", "type": "boolean", "description": "Leave out places Google marks as permanently or temporarily closed. They are not saved and not billed.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave as is: the Actor uses Apify's datacenter proxy and retries through residential IPs on its own, at no extra cost to you. Only your own proxy URLs (if you add them) override this.", "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 }, "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 } } } } } } } } } }