{ "openapi": "3.0.1", "info": { "title": "Google Maps Scraper: Places, Leads & Email Extractor", "description": "Scrape Google Maps places and business leads by keyword and location: name, category, rating, review count, address, coordinates, phone, website, opening hours and IDs. Covers whole cities with an automatic map grid. Optional add-on finds emails and social links on websites. Pay per place.", "version": "0.2", "x-build-id": "Gm6FPi7Z0wumrdAOb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xmolodtsov~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xmolodtsov-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/xmolodtsov~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-xmolodtsov-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/xmolodtsov~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-xmolodtsov-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", "required": [ "searchStringsArray" ], "properties": { "searchStringsArray": { "title": "Search terms", "type": "array", "description": "What you would type into Google Maps, e.g. \"dentist\" or \"coffee shop\". One search per term. Add the place to each term (\"dentist in Austin\") or use Location below.", "items": { "type": "string" } }, "locationQuery": { "title": "Location", "type": "string", "description": "City, region or country, e.g. \"Austin, TX, USA\". Each term is searched as \" in \"; when you ask for more places than one search returns, the actor tiles the location's map area and searches every tile." }, "maxCrawledPlacesPerSearch": { "title": "Max places per search term", "minimum": 1, "type": "integer", "description": "Stop each search term after this many places, e.g. 100. Leave empty to keep collecting until Google Maps returns no new places for the term and location; with a Location set, a whole city can return thousands of places, each billed. On the Apify free plan every run is capped at 100 places and 20 runs per month (a limit set by the developer, not by Apify); any paid plan is unlimited." }, "scrapeContacts": { "title": "Add-on: emails & social links from each place's website ($)", "type": "boolean", "description": "Visits each place's own website (the homepage plus up to 2 contact/about pages) and adds what it finds there: `emails`, `phones`, `facebooks`, `instagrams`, `linkedIns`, `twitters`, `youtubes`, `tiktoks`, `pinterests`, `discords`. Respects each site's robots meta tags (noindex / nofollow). Charged per place only when at least one email or social link is found, never on a miss (see Pricing in the README). Makes runs slower.", "default": false }, "website": { "title": "Website filter", "enum": [ "allPlaces", "withWebsite", "withoutWebsite" ], "type": "string", "description": "Keep all places, only places with a website, or only places without one (useful for web-design lead lists).", "default": "allPlaces" }, "language": { "title": "Language", "type": "string", "description": "Language of category names, opening hours and amenity labels (Google `hl` code, e.g. en, de, fr, es).", "default": "en" }, "countryCode": { "title": "Country (phone format & ranking)", "type": "string", "description": "Optional two-letter country code (Google `gl`), e.g. us or de. Phones of places in this country come back in national format." }, "placeMinimumStars": { "title": "Minimum rating", "enum": [ "", "two", "twoAndHalf", "three", "threeAndHalf", "four", "fourAndHalf" ], "type": "string", "description": "Skip places rated below this.", "default": "" }, "skipClosedPlaces": { "title": "Skip closed places", "type": "boolean", "description": "Skip places Google marks as permanently or temporarily closed.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy settings. The default works; change only if you know you need to.", "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 } } } } } } } } } }