{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper — Places, Storefront vs Service-Area", "description": "Scrape Google Maps business listings by keyword and city: name, category, phone, website, address, hours, rating and booking link. Flags service-area businesses that hide their address. Clean, de-duplicated, no personal data. $1 per 1,000 places.", "version": "0.1", "x-build-id": "9I0Gyvbn1YAyRP1St" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jaybird~google-maps-places-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jaybird-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/jaybird~google-maps-places-scraper/runs": { "post": { "operationId": "runs-sync-jaybird-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/jaybird~google-maps-places-scraper/run-sync": { "post": { "operationId": "run-sync-jaybird-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": [ "searchTerms", "location" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search for, as you would type it into Google Maps (\"plumber\", \"mobile iv therapy\", \"coffee shop\"). Each term runs as its own search inside the location. Places found by several terms are saved once, listing every matching term.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "One city, metro or region per run, as free text (\"Austin, TX, USA\", \"Manchester, UK\"). It is geocoded once and every term is searched inside that map area." }, "customGeolocation": { "title": "Custom area (GeoJSON polygon)", "type": "object", "description": "Optional. A GeoJSON Polygon or MultiPolygon (or a Feature holding one) for a whole metro. When set, searches are centred on it and places outside it are dropped. \"Location\" is still used as the label in the output." }, "maxPlacesPerSearch": { "title": "Max places per search term", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap per search term, before duplicates across terms are removed. One map view returns up to about 200 places; above that the area is split into smaller map tiles automatically, so large caps take longer and cost more.", "default": 60 }, "language": { "title": "Language", "type": "string", "description": "Language for Google Maps results, e.g. \"en\", \"es\", \"de\". Affects category names, hours and descriptions.", "default": "en" }, "skipPermanentlyClosed": { "title": "Skip permanently closed places", "type": "boolean", "description": "Leave out places Google marks as permanently closed.", "default": true }, "maxDistanceKm": { "title": "Max distance from location (km)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Drop places whose map pin is farther than this from the location. Leave empty for an automatic radius sized to the location (about 63 km for Austin); 0 turns the filter off. Ignored when a custom area is set. Places that hide their location are always kept." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google blocks datacenter IPs on Maps, so US residential proxies are the default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }