{
"openapi": "3.0.1",
"info": {
"title": "Google Maps Scraper",
"description": "Stop wasting your budget on slow, resource-heavy browser-based scrapers. This is the fastest, most cost-effective, and data-rich Google Maps scraper on Apify, designed for high-scale lead generation and market research.",
"version": "3.0",
"x-build-id": "310RuRSrJRprj0n2p"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vortex_data~google-maps/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vortex_data-google-maps",
"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/vortex_data~google-maps/runs": {
"post": {
"operationId": "runs-sync-vortex_data-google-maps",
"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/vortex_data~google-maps/run-sync": {
"post": {
"operationId": "run-sync-vortex_data-google-maps",
"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",
"maxItems": 100,
"uniqueItems": true,
"type": "array",
"description": "What you would type into Google Maps: restaurant, dentist, recording studio. One per line — each term is searched in every Location.
Leave the city out of the term. A term that names the place searches for it twice and returns less.",
"items": {
"type": "string"
}
},
"locationQueries": {
"title": "📍 Locations",
"maxItems": 50,
"uniqueItems": true,
"type": "array",
"description": "One place per line: New York, USA, Brooklyn, New York, United States, Bavaria, Germany. Each is searched on its own, and the places limit below applies to every term in every location.
City plus country works best. Two places on one line resolve to neither.",
"items": {
"type": "string"
}
},
"maxCrawledPlacesPerSearch": {
"title": "💯 Places to extract",
"minimum": 10,
"maximum": 100000,
"type": "integer",
"description": "How many places to keep for each search term in each location. Use 50 for a quick test, 500 or more for a city-scale lead list.
Asking for more than an area holds makes the run longer, not richer: Google starts answering with whatever else is nearby.",
"default": 50
},
"geoStrictMatch": {
"title": "📍 Only places inside the area",
"type": "boolean",
"description": "Drops every place outside the resolved area — not saved, not charged. A place just past the boundary still counts as inside when Google files it under the city you asked for.
Off: nearby towns are kept too, marked insideSearchArea=false.",
"default": false
},
"keepUnverifiedLocations": {
"title": "🚚 Keep businesses with no address",
"type": "boolean",
"description": "A mobile plumber or a studio run from home has no address on Google and a placeholder coordinate, so strict matching has nothing to check and drops it. On: kept anyway, flagged locationUnverified=true, with an empty address.
Often the best rows for lead generation.",
"default": false
},
"skipClosedPlaces": {
"title": "⏩ Skip closed places",
"type": "boolean",
"description": "Leaves out places Google marks temporarily or permanently closed.",
"default": false
},
"skipPlacesNotMatchingSearch": {
"title": "⏩ Only what you searched for",
"type": "boolean",
"description": "When an area runs out of what you asked for, Google pads the answer with whatever else is there. Turn this on to drop those rows, never charged.
Not a 100% guarantee: it judges best when a term names a kind of place (dentist, coffee shop); vague terms may stay unjudged. Every row carries searchTermMatch either way.",
"default": false
},
"languages": {
"title": "🌍 Languages",
"maxItems": 6,
"uniqueItems": true,
"type": "array",
"description": "The language Google answers in: names, categories, addresses.
Add more to search the same ground again in another language — each pass surfaces places the previous one buried, and costs another pass. Not in the list? Type any ISO code (cs, pt-BR) and press Enter.",
"items": {
"type": "string",
"enumSuggestedValues": [
"en",
"es",
"fr",
"de",
"it",
"pt",
"nl",
"sv",
"fi",
"pl",
"ru",
"uk",
"tr",
"ar",
"hi",
"ja",
"ko",
"zh-CN"
],
"enumTitles": [
"English",
"Spanish",
"French",
"German",
"Italian",
"Portuguese",
"Dutch",
"Swedish",
"Finnish",
"Polish",
"Russian",
"Ukrainian",
"Turkish",
"Arabic",
"Hindi",
"Japanese",
"Korean",
"Chinese"
]
},
"default": [
"en"
]
},
"extractContactsFromWebsite": {
"title": "Collect contacts from each website",
"type": "boolean",
"description": "Takes emails, extra phone numbers and social links from the business's own site. The homepage first, then one contact page only if no email was found — never a crawl.
Only works where a place has a website. Enriched places are charged separately.",
"default": false
},
"maxReviewsPerPlace": {
"title": "Reviews per place",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "How many reviews to attach to each place. 0 is the fastest run; large values make every place slower and its row much bigger.",
"default": 0
},
"reviewsSort": {
"title": "Sort reviews by",
"enum": [
"newest",
"most_relevant",
"highest",
"lowest"
],
"type": "string",
"description": "Which reviews come first. Google returns its own order for some places whatever is asked.",
"default": "newest"
},
"customGeolocation": {
"title": "🛰 Custom search area (GeoJSON)",
"type": "object",
"description": "An exact area instead of a named place — a district you drew, a delivery zone, a radius around a point.
Paste what your map editor exported (geojson.io, QGIS, My Maps): FeatureCollection, Feature, Polygon, MultiPolygon, or a Point with radiusKm. Several shapes are all searched; very small ones can come back empty."
},
"startUrls": {
"title": "🔗 Google Maps URLs",
"maxItems": 500,
"type": "array",
"description": "One URL per line.
A place: open it and use Share → Copy link (maps.app.goo.gl/… or …/maps/place/…). A copied search page (…/maps/search/coffee/@60.17,24.94,13z) is scraped as that map view. Short links are followed for you.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "🗃 Place IDs",
"maxItems": 500,
"uniqueItems": true,
"type": "array",
"description": "One per line, from the Places API, Google's Place ID Finder, or the query_place_id parameter of a Maps URL.
Full IDs only — not URLs, not short /g/… ids, not fids.",
"items": {
"type": "string"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}