{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper - Places, Phones, Websites and Ratings", "description": "Google Maps scraper and Places API alternative: local businesses by search term and location with name, categories, full address, coordinates, phone, website, rating, review count, opening hours, closed status, place ID and CID. Lead lists, no browser, no API key.", "version": "0.1", "x-build-id": "CZ32ApAfhjlOxJNZB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sweet_stickball~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sweet_stickball-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/sweet_stickball~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-sweet_stickball-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/sweet_stickball~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-sweet_stickball-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search on Google Maps, one search per term, as you would type it in the Maps search box: a business type ('dentist', 'coffee shop', 'roofing contractor') or a name ('Starbucks'). Each term is combined with 'location'. Leave empty if you use 'searchUrls'.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Area to search in, added to every search term ('dentist' + 'Austin, TX' = 'dentist in Austin, TX'). A city, neighborhood, region, ZIP code or 'City, Country'. Without a location Google picks the area from the proxy IP, so set one for local results." }, "searchUrls": { "title": "Google Maps search URLs", "type": "array", "description": "Optional. Google Maps search URLs copied from the browser, e.g. https://www.google.com/maps/search/pizza/@41.9028,12.4964,14z. The query and, when present, the map position (@lat,lng,zoom) are used. Place URLs (/maps/place/...) are not supported.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum places per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of places returned for each search term or URL (after the minRating filter). Google Maps lists about 120 places per search at most; use more specific terms or several locations for more.", "default": 20 }, "language": { "title": "Language", "type": "string", "description": "Language of the results (Google 'hl' code): en, fr, de, es, pt-BR... Affects category names, opening hours text and some addresses.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the Google domain to search as (Google 'gl' code: us, gb, de, fr...). The location decides where places are; this only adjusts ranking and formats.", "default": "us" }, "minRating": { "title": "Minimum rating", "enum": [ "", "3", "3.5", "4", "4.5" ], "type": "string", "description": "Keep only places rated at least this many stars. Places without any rating are dropped when a minimum is set.", "default": "" }, "includeDetails": { "title": "Include place details", "type": "boolean", "description": "One extra request per place to add the business description and the number of reviews per star (1 to 5). Slower. Opening hours, phone and website are returned without this option.", "default": 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 } } } } } } } } } }