{ "openapi": "3.0.1", "info": { "title": "Google Maps Places & Business Scraper", "description": "Scrape Google Maps business listings at scale — name, category, full address, GPS, phone, website, rating, review count, opening hours and photos as clean JSON. Built for lead generation, local SEO and market research. Simple, transparent pricing — pay only for the results you get.", "version": "1.0", "x-build-id": "eW5Fq3cOb5yWPSG6B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~google-maps-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-google-maps-places-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/axlymxp~google-maps-places-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-google-maps-places-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/axlymxp~google-maps-places-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-google-maps-places-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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search terms", "type": "array", "description": "Keywords or business categories to search for on Google Maps, e.g. \"restaurants\", \"dentist\", \"coffee shops\". Each term is searched within the chosen location. You can also embed the place in the term (e.g. \"plumbers in Austin\") and leave Location empty.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City / area to search within, e.g. \"San Francisco, CA\" or \"Berlin, Germany\". It is geocoded to a map viewport (via OpenStreetMap). Leave empty to geocode each search term instead, or set Custom coordinates below for precise control." }, "customCoordinates": { "title": "Custom coordinates (advanced)", "type": "object", "description": "Optional. Override Location with an exact viewport centre: {\"lat\": 37.7749, \"lng\": -122.4194, \"zoom\": 14}. Zoom 11≈city, 14≈district, 16≈neighborhood." }, "zoom": { "title": "Zoom / search radius", "minimum": 3, "maximum": 20, "type": "integer", "description": "Map zoom used for the search viewport. Lower = wider area, higher = tighter. 11≈city, 14≈district, 16≈neighborhood.", "default": 14 }, "maxItems": { "title": "Max results (total)", "minimum": 1, "type": "integer", "description": "Stop the whole run after this many places (across all search terms). Google caps a single term+area at roughly 120–200 places; widen the area or add terms for more.", "default": 100 }, "enrichPlaceDetails": { "title": "Enrich place details (extra charge)", "type": "boolean", "description": "Fetch one extra request per place to add full-week opening hours, the full photo gallery and the editorial summary. Slower and billed per enriched place — off by default.", "default": false }, "includePhotos": { "title": "Include photos", "type": "boolean", "description": "Include the array of place photos (id, full-resolution URL, size, caption) in each row.", "default": true }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "ru", "ja", "zh-CN", "ar" ], "type": "string", "description": "Response language for names, categories and hours.", "default": "en" }, "countryCode": { "title": "Country bias", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "jp", "br", "in", "ae" ], "type": "string", "description": "Country to bias results toward (Google 'gl' parameter).", "default": "us" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google Maps rate-limits per IP, so a rotating proxy is strongly recommended. Defaults to Apify Residential proxy; the actor rotates the session on any rate-limit.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } }, "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 } } } } } } } } } }