{
"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": "1.5",
"x-build-id": "Y1TdeObeLtu9kZIvl"
},
"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 term(s)",
"uniqueItems": true,
"type": "array",
"description": "Type what you would normally search for in Google Maps, for example restaurant, recording studio, dentist, or taksi. Add one search term per line.
💡 Use specific terms for cleaner results. Very similar terms may improve coverage, but they also make the run longer.
⚠️ Looking for a specific business name? Add a clear 📍 Location too, otherwise Google Maps may return the matching name from another city or country.",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "📍 Location (use only one location per run)",
"type": "string",
"description": "Define the search area with simple free text. Good examples: Helsinki, Finland, Los Angeles, United States, Brooklyn, New York, Berlin, Germany.
Simple formats usually work best: City + Country, or Neighborhood + City. If the area is not exactly what you need, use 📡 Geolocation parameters* or 🛰 Custom search area* below.
⚠️ This field has priority over Country / City / Postal code fields. Clear it if you want to use the structured geolocation fields."
},
"maxCrawledPlacesPerSearch": {
"title": "💯 Number of places to extract (per each search term or URL)",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum number of places to keep for each search term or direct URL. Higher values take longer and may use more requests.
For quick tests, use 50. For city-scale lead lists, use 500 or more.",
"default": 50
},
"language": {
"title": "🌍 Language",
"enum": [
"en",
"fi",
"sv",
"es",
"fr",
"de",
"it",
"pt",
"ru",
"uk",
"pl",
"tr",
"nl",
"ja",
"ko",
"zh-CN",
"ar",
"hi"
],
"type": "string",
"description": "Google Maps language used for names, categories, addresses, and labels.",
"default": "en"
},
"categoryFilterWords": {
"title": "🎢 Place categories",
"uniqueItems": true,
"type": "array",
"description": "Keep only places whose Google category contains at least one of these words. Example: pizza keeps places categorized as Pizza restaurant; asian keeps Asian restaurant.
⚠️ Categories are useful, but can create false negatives because Google categories are inconsistent. Search terms are usually safer for broad coverage.",
"items": {
"type": "string"
}
},
"searchMatching": {
"title": "Get exact name matches (no similar results)",
"enum": [
"all",
"only_includes",
"only_exact"
],
"type": "string",
"description": "Restrict places based on how their name matches the 🔍 Search term. Use this when you need brand/name precision instead of normal Google Maps matching.",
"default": "all"
},
"placeMinimumStars": {
"title": "Set a minimum star rating",
"enum": [
"",
"two",
"twoAndHalf",
"three",
"threeAndHalf",
"four",
"fourAndHalf"
],
"type": "string",
"description": "Scrape only places with a rating equal to or above the selected value. Places without a visible rating are skipped when this filter is enabled.",
"default": ""
},
"websiteFilter": {
"title": "Scrape places with/without a website",
"enum": [
"allPlaces",
"withWebsite",
"withoutWebsite"
],
"type": "string",
"description": "Use this to keep only places with a website, only places without a website, or all places.
💡 For email/contact enrichment, choose Only with a website. If you choose Only without a website, website contact enrichment is automatically disabled because there is no website to visit.",
"default": "allPlaces"
},
"skipClosedPlaces": {
"title": "⏩ Skip closed places",
"type": "boolean",
"description": "Skip places that Google marks as temporarily or permanently closed. Useful when you only want currently active businesses.",
"default": false
},
"extractContactsFromWebsite": {
"title": "⏩ Add-on: Company contacts enrichment (from website)",
"type": "boolean",
"description": "Visit each business website and extract business emails, extra phone numbers, and social media links such as Facebook, Instagram, LinkedIn, X / Twitter, YouTube, TikTok, Pinterest, and WhatsApp.
💡 For best results, combine this with Scrape only places with a website in the Search filters section.",
"default": false
},
"skipPlacesWithoutEmail": {
"title": "📭 Keep only places with an email",
"type": "boolean",
"description": "Drop places where website enrichment did not find an email. Use this for clean cold-outreach lead lists.
⚠️ This has no effect unless company contacts enrichment is enabled.",
"default": false
},
"contactsFetchContactPage": {
"title": "Try a contact page if homepage has no email",
"type": "boolean",
"description": "If the homepage has no email, try one common contact-style page such as /contact, /contact-us, or /impressum.",
"default": true
},
"contactsSkipChains": {
"title": "Skip global chains during contact enrichment",
"type": "boolean",
"description": "Skip enrichment for large chains whose corporate websites rarely contain useful local branch emails.",
"default": true
},
"contactsTimeoutSecs": {
"title": "Website timeout",
"minimum": 3,
"maximum": 60,
"type": "integer",
"description": "Maximum seconds to wait for each business website during contact enrichment.",
"default": 10
},
"maxReviewsPerPlace": {
"title": "Number of reviews to extract",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "How many reviews to attach to each place. Set to 0 for the fastest run. Reviews are fetched from Google's paginated review feed; large values can take noticeably longer and use more requests.",
"default": 0
},
"reviewsSort": {
"title": "Sort reviews by",
"enum": [
"newest",
"most_relevant",
"highest",
"lowest"
],
"type": "string",
"description": "Requested review ordering for Google's paginated reviews endpoint. Google can still return its default ordering for some places.",
"default": "newest"
},
"additionalLanguages": {
"title": "➕ Extra languages",
"uniqueItems": true,
"type": "array",
"description": "Run the same search again in extra Google Maps languages, for example fi, sv, es, de. Each extra language adds another full pass and can uncover slightly different translated categories and rankings.",
"items": {
"type": "string"
},
"default": []
},
"countryCode": {
"title": "🗺 Country",
"type": "string",
"description": "Alternative way to define the search area. Used only when 📍 Location is empty. Use ISO country code, for example US, FI, DE."
},
"city": {
"title": "🌇 City",
"type": "string",
"description": "City name used only when 📍 Location is empty.
⚠️ Do not include state or country here; use the separate fields."
},
"state": {
"title": "State / region",
"type": "string",
"description": "State, province, or region used only when 📍 Location is empty. Mainly useful for countries such as the United States."
},
"county": {
"title": "County",
"type": "string",
"description": "County or similar regional unit used only when 📍 Location is empty."
},
"postalCode": {
"title": "Postal code",
"type": "string",
"description": "ZIP / postal code used only when 📍 Location is empty.
⚠️ Use one postal code at a time."
},
"customGeolocation": {
"title": "🛰 Custom search area (GeoJSON)",
"type": "object",
"description": "Define an exact custom search area with GeoJSON. Supported inputs: Polygon, MultiPolygon, or Point with radiusKm.
Use this when automatic city boundaries are too small, too large, or when you need a custom service area."
},
"startUrls": {
"title": "Google Maps URLs",
"type": "array",
"description": "Paste Google Maps place URLs such as google.com/maps/place/.... Each place URL is fetched directly and does not need a search term or location.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "🗃 Place IDs",
"uniqueItems": true,
"type": "array",
"description": "List of Google Place IDs. A Place ID usually looks like ChIJreV9aqYWdkgROM_boL6YbwA. Add one ID per line.",
"items": {
"type": "string"
}
},
"maxPlacesPerViewport": {
"title": "Places per map viewport",
"minimum": 1,
"maximum": 120,
"type": "integer",
"description": "Maximum places fetched from one Google Maps viewport. Values above 120 do not help because Google caps each viewport response.",
"default": 80
},
"enableSubdivision": {
"title": "Split dense areas automatically",
"type": "boolean",
"description": "When a map area is dense, split it into smaller quadrants to get past Google's visible-result cap. Recommended for city and region searches.",
"default": true
},
"maxSubdivisionDepth": {
"title": "Maximum split depth",
"minimum": 0,
"maximum": 7,
"type": "integer",
"description": "How deep automatic area splitting can go. Higher values can find more places in dense cities, but use more requests.",
"default": 4
},
"multiZoomDelta": {
"title": "Extra zoom passes",
"minimum": 0,
"maximum": 3,
"type": "integer",
"description": "Search nearby zoom levels around the resolved area. 0 disables this. 1 can improve coverage but roughly triples search requests.",
"default": 0
},
"zoom": {
"title": "Override zoom level",
"minimum": 1,
"maximum": 21,
"type": "integer",
"description": "Override the automatically chosen Google Maps zoom level. Leave empty unless you need precise control."
},
"reverseGeocodeMissingAddress": {
"title": "Fill missing addresses from coordinates",
"type": "boolean",
"description": "When Google returns coordinates but no address text, backfill the address from OpenStreetMap-based geocoding. This is free and cached.",
"default": true
},
"concurrency": {
"title": "Concurrent workers",
"minimum": 1,
"maximum": 32,
"type": "integer",
"description": "How many scraping tasks run in parallel. Higher values are faster but use more proxy bandwidth.",
"default": 8
},
"requestTimeoutSecs": {
"title": "Google request timeout",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "Maximum seconds to wait for each Google request. Increase this if residential proxy responses are slow.",
"default": 30
},
"minRequestIntervalMs": {
"title": "Delay between Google requests",
"minimum": 0,
"maximum": 5000,
"type": "integer",
"description": "Minimum delay in milliseconds between Google requests. Lower values are faster; higher values are gentler when proxies are unstable.",
"default": 250
}
}
},
"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
}
}
}
}
}
}
}
}
}
}