Google Maps➤ You are here
DirectionsRoutes, ETA, steps
Apple MapsPhones, ratings, hours
Yandex MapsLeads, reviews, API
2GIS PlacesPhones, emails, reviews
40+ fields on every place — not just the top 250 Google shows you — full address, phone, opening hours, hour-by-hour popular times, amenities, reservation links, photos, and reviews, at hundreds of places per minute. The richest Google Maps output on Apify.
| Zen Studio Maps Suite • Places, reviews, and routes across every major map provider | ||||
|
Google Maps ➤ You are here |
Directions Routes, ETA, steps |
Apple Maps Phones, ratings, hours |
Yandex Maps Leads, reviews, API |
2GIS Places Phones, emails, reviews |
**Google Maps**
- [Google Maps Directions & Routes API](https://apify.com/zen-studio/google-maps-directions-api)
- **Apple Maps**
- [Apple Maps Scraper](https://apify.com/zen-studio/apple-maps-scraper-pro)
- [Apple Maps Directions & Route API](https://apify.com/zen-studio/apple-maps-directions-route-api)
- **Yandex Maps Яндекс Карты**
- [Yandex Maps Scraper](https://apify.com/zen-studio/yandex-maps-scraper)
- [Yandex Maps Reviews Scraper](https://apify.com/zen-studio/yandex-maps-reviews-scraper)
- **2GIS 2ГИС**
- [2GIS Places Scraper](https://apify.com/zen-studio/2gis-places-scraper-api)
- [2GIS Reviews Scraper](https://apify.com/zen-studio/2gis-reviews-scraper)
### Support
- **Bugs**: Issues tab
- **Features**: Issues tab
### Legal Compliance
Extracts publicly available data. Users must comply with Google Maps terms of service and data protection regulations (GDPR, CCPA).
***
*The richest Google Maps scraper on Apify — every place auto-enriched with 40+ fields, hour-by-hour popular times, amenities, and reservation links, hundreds per minute. Goes past Google's 250-per-view ceiling.*
# Actor input Schema
## `searchStringsArray` (type: `array`):
What you'd type into the Google Maps search bar. One term per line, e.g. restaurants or family dentist.
## `locationQuery` (type: `string`):
Where to search. Type it like you would in Google Maps: Astoria, NY, Berlin Germany, 90210, or a full street address. Required together with Search terms, unless you use the structured or custom-area fields below.
## `maxCrawledPlacesPerSearch` (type: `integer`):
How many places you want per search term. The actor systematically scans the location until it reaches this number or runs out of results. Smaller numbers finish faster.
## `city` (type: `string`):
City name only (no state or country — those have their own fields). Use instead of Location when you want a structured query.
## `state` (type: `string`):
State or region. Pairs well with City in countries that use states (US, AU, IN, BR, MX, DE).
## `county` (type: `string`):
County (US), regional district (CA), département (FR), or local equivalent.
## `postalCode` (type: `string`):
Postal/ZIP code. Combine with Country code only — never with City (they conflict).
## `customGeolocation` (type: `object`):
GeoJSON Point or Polygon defining the exact area to search. Coordinate order is \[longitude, latitude]. When set, this overrides all other location fields.
## `startUrls` (type: `array`):
Skip the search step and scrape these places directly. Accepts /maps/place/..., /maps?cid=..., and shortened URLs.
## `placeIds` (type: `array`):
Google Maps place IDs like ChIJN1t\_tDeuEmsRUsoyG83frY4. The place\_id: prefix is accepted but optional.
## `categoryFilterWord` (type: `string`):
Restrict results to one Google place category, given as its slug — e.g. chinese\_restaurant, hotel, plumber, coffee\_shop, dentist. Leave blank to include everything your search term returns.restaurants + chinese\_restaurant).
## `placeMinimumStars` (type: `string`):
Drop places below this average rating. Leave blank to include unrated places too.
## `priceMin` (type: `integer`):
Lowest typical dining price per person to include, in the local currency of your selected Country (e.g. 20 for $20 / €20). Leave at 0 for no lower limit. Only affects restaurant-type places.
## `priceMax` (type: `integer`):
Highest typical dining price per person to include, in the local currency of your selected Country (e.g. 60 for $60 / €60). Leave at 0 to turn the price filter off. Only affects restaurant-type places.
## `openNow` (type: `boolean`):
Restrict to places that are currently open (in their local time).
## `skipClosedPlaces` (type: `boolean`):
Drop places marked permanently closed by Google.
## `websiteFilter` (type: `string`):
Keep places with a website, without one, or both.
## `searchMatching` (type: `string`):
How strictly the place name has to match your search term. Anything Google returns is the default and matches the usual Google Maps behavior.
## `maxReviews` (type: `integer`):
0 = no reviews. Set to a large number (e.g. 99999) to fetch all available. Each review is billed at $0.50/1k.
## `reviewsSort` (type: `string`):
Sort order applied when fetching reviews. Newest first is most useful for monitoring; Most relevant matches the Google UI default.
## `reviewsFilterString` (type: `string`):
Keep only reviews whose text contains this substring (case-insensitive). Leave blank to keep all. Useful for over-fetching, then narrowing.
## `reviewsOrigin` (type: `string`):
Whether to include reviews from partner sources (Tripadvisor, Booking, etc.) or restrict to Google-native reviews only.
## `maxImages` (type: `integer`):
0 = no photos. Each photo includes its tabs (All, Latest, Menu, Vibe, plus dish tabs), upload date, and source. Typical popular places have 100–200 photos available.
## `maxVideos` (type: `integer`):
0 = no videos. Each video includes the poster image plus HLS, DASH, and best-quality MP4 stream URLs.
## `excludeFields` (type: `array`):
Tick any fields you don't need — they get dropped from every place row to keep your dataset small. None are required for the actor to work; defaults include everything.
## `language` (type: `string`):
Display language used when fetching results. Affects category labels and review text language preference.
## `countryCode` (type: `string`):
Country used to bias search results geographically. The first 19 entries are common defaults; the rest are alphabetical.
## Actor input object example
```json
{
"searchStringsArray": [
"restaurants"
],
"locationQuery": "Astoria, NY",
"maxCrawledPlacesPerSearch": 50,
"city": "",
"state": "",
"county": "",
"postalCode": "",
"startUrls": [],
"placeIds": [],
"categoryFilterWord": "",
"placeMinimumStars": "",
"priceMin": 0,
"priceMax": 0,
"openNow": false,
"skipClosedPlaces": false,
"websiteFilter": "all",
"searchMatching": "all",
"maxReviews": 0,
"reviewsSort": "newest",
"reviewsFilterString": "",
"reviewsOrigin": "all",
"maxImages": 0,
"maxVideos": 0,
"excludeFields": [],
"language": "en",
"countryCode": "us"
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the 'restaurants or family dentist.",
"items": {
"type": "string"
}
},
"locationQuery": {
"title": "Location — city, neighborhood, address, or ZIP",
"type": "string",
"description": "Where to search. Type it like you would in Google Maps: Astoria, NY, Berlin Germany, 90210, or a full street address. Required together with Search terms, unless you use the structured or custom-area fields below."
},
"maxCrawledPlacesPerSearch": {
"title": "Max places per search term",
"minimum": 1,
"type": "integer",
"description": "How many places you want per search term. The actor systematically scans the location until it reaches this number or runs out of results. Smaller numbers finish faster.",
"default": 50
},
"city": {
"title": "City",
"type": "string",
"description": "City name only (no state or country — those have their own fields). Use instead of Location when you want a structured query.",
"default": ""
},
"state": {
"title": "State / Region",
"type": "string",
"description": "State or region. Pairs well with City in countries that use states (US, AU, IN, BR, MX, DE).",
"default": ""
},
"county": {
"title": "County / District / Département",
"type": "string",
"description": "County (US), regional district (CA), département (FR), or local equivalent.",
"default": ""
},
"postalCode": {
"title": "Postal code",
"type": "string",
"description": "Postal/ZIP code. Combine with Country code only — never with City (they conflict).",
"default": ""
},
"customGeolocation": {
"title": "Custom search area (GeoJSON)",
"type": "object",
"description": "GeoJSON Point or Polygon defining the exact area to search. Coordinate order is [longitude, latitude]. When set, this overrides all other location fields."
},
"startUrls": {
"title": "Google Maps URLs",
"type": "array",
"description": "Skip the search step and scrape these places directly. Accepts /maps/place/..., /maps?cid=..., and shortened URLs.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "Place IDs",
"type": "array",
"description": "Google Maps place IDs like ChIJN1t_tDeuEmsRUsoyG83frY4. The place_id: prefix is accepted but optional.",
"items": {
"type": "string"
}
},
"categoryFilterWord": {
"title": "Category filter",
"type": "string",
"description": "Restrict results to one Google place category, given as its slug — e.g. chinese_restaurant, hotel, plumber, coffee_shop, dentist. Leave blank to include everything your search term returns.restaurants + chinese_restaurant).",
"default": ""
},
"placeMinimumStars": {
"title": "Minimum rating",
"enum": [
"",
"2.0",
"2.5",
"3.0",
"3.5",
"4.0",
"4.5"
],
"type": "string",
"description": "Drop places below this average rating. Leave blank to include unrated places too.",
"default": ""
},
"priceMin": {
"title": "Min price per person (restaurants)",
"minimum": 0,
"type": "integer",
"description": "Lowest typical dining price per person to include, in the local currency of your selected Country (e.g. 20 for $20 / €20). Leave at 0 for no lower limit. Only affects restaurant-type places.",
"default": 0
},
"priceMax": {
"title": "Max price per person (restaurants)",
"minimum": 0,
"type": "integer",
"description": "Highest typical dining price per person to include, in the local currency of your selected Country (e.g. 60 for $60 / €60). Leave at 0 to turn the price filter off. Only affects restaurant-type places.",
"default": 0
},
"openNow": {
"title": "Open now only",
"type": "boolean",
"description": "Restrict to places that are currently open (in their local time).",
"default": false
},
"skipClosedPlaces": {
"title": "Skip permanently closed",
"type": "boolean",
"description": "Drop places marked permanently closed by Google.",
"default": false
},
"websiteFilter": {
"title": "Website filter",
"enum": [
"all",
"with_website",
"without_website"
],
"type": "string",
"description": "Keep places with a website, without one, or both.",
"default": "all"
},
"searchMatching": {
"title": "Name match strictness",
"enum": [
"all",
"only_includes",
"only_exact"
],
"type": "string",
"description": "How strictly the place name has to match your search term. Anything Google returns is the default and matches the usual Google Maps behavior.",
"default": "all"
},
"maxReviews": {
"title": "Reviews per place",
"minimum": 0,
"type": "integer",
"description": "0 = no reviews. Set to a large number (e.g. 99999) to fetch all available. Each review is billed at $0.50/1k.",
"default": 0
},
"reviewsSort": {
"title": "Reviews sort",
"enum": [
"newest",
"mostRelevant",
"highestRanking",
"lowestRanking"
],
"type": "string",
"description": "Sort order applied when fetching reviews. Newest first is most useful for monitoring; Most relevant matches the Google UI default.",
"default": "newest"
},
"reviewsFilterString": {
"title": "Filter reviews by keyword",
"type": "string",
"description": "Keep only reviews whose text contains this substring (case-insensitive). Leave blank to keep all. Useful for over-fetching, then narrowing.",
"default": ""
},
"reviewsOrigin": {
"title": "Reviews origin",
"enum": [
"all",
"google"
],
"type": "string",
"description": "Whether to include reviews from partner sources (Tripadvisor, Booking, etc.) or restrict to Google-native reviews only.",
"default": "all"
},
"maxImages": {
"title": "Photos per place",
"minimum": 0,
"type": "integer",
"description": "0 = no photos. Each photo includes its tabs (All, Latest, Menu, Vibe, plus dish tabs), upload date, and source. Typical popular places have 100–200 photos available.",
"default": 0
},
"maxVideos": {
"title": "Videos per place",
"minimum": 0,
"type": "integer",
"description": "0 = no videos. Each video includes the poster image plus HLS, DASH, and best-quality MP4 stream URLs.",
"default": 0
},
"excludeFields": {
"title": "Trim heavy fields from output",
"uniqueItems": true,
"type": "array",
"description": "Tick any fields you don't need — they get dropped from every place row to keep your dataset small. None are required for the actor to work; defaults include everything.",
"items": {
"type": "string",
"enum": [
"popularTimes",
"amenities",
"relatedPlaces",
"metaDescription",
"reviewTeasers",
"bookingPartners",
"immersiveView",
"categoryGcids"
],
"enumTitles": [
"Popular times (7 days × 24 hours busyness chart) — ~10 KB/place",
"Amenities (14 sections × items) — ~2 KB/place",
"Related places (\"people also search for\") — ~3 KB/place",
"Meta description (long marketing text) — ~1 KB/place",
"Review teasers (featured snippets, author profile + photo)",
"Booking partners (Resy, OpenTable provider blocks with logos)",
"Immersive View (360° media URLs)",
"Category GCIDs (machine-readable category slugs — keeps the human-readable 'Categories' field)"
]
}
},
"language": {
"title": "Language",
"enum": [
"en",
"de",
"fr",
"es",
"it",
"pt",
"nl",
"pl",
"ja",
"zh-CN",
"zh-TW",
"ko",
"ar",
"tr",
"ru"
],
"type": "string",
"description": "Display language used when fetching results. Affects category labels and review text language preference.",
"default": "en"
},
"countryCode": {
"title": "Country code",
"enum": [
"us",
"gb",
"de",
"fr",
"ca",
"au",
"in",
"jp",
"cn",
"br",
"mx",
"es",
"it",
"nl",
"pl",
"tr",
"ru",
"kr",
"sa",
"ad",
"ae",
"af",
"ag",
"ai",
"al",
"am",
"ao",
"aq",
"ar",
"as",
"at",
"aw",
"ax",
"az",
"ba",
"bb",
"bd",
"be",
"bf",
"bg",
"bh",
"bi",
"bj",
"bl",
"bm",
"bn",
"bo",
"bq",
"bs",
"bt",
"bv",
"bw",
"by",
"bz",
"cc",
"cd",
"cf",
"cg",
"ch",
"ci",
"ck",
"cl",
"cm",
"co",
"cr",
"cu",
"cv",
"cw",
"cx",
"cy",
"cz",
"dj",
"dk",
"dm",
"do",
"dz",
"ec",
"ee",
"eg",
"eh",
"er",
"et",
"fi",
"fj",
"fk",
"fm",
"fo",
"ga",
"gd",
"ge",
"gf",
"gg",
"gh",
"gi",
"gl",
"gm",
"gn",
"gp",
"gq",
"gr",
"gs",
"gt",
"gu",
"gw",
"gy",
"hk",
"hm",
"hn",
"hr",
"ht",
"hu",
"id",
"ie",
"il",
"im",
"io",
"iq",
"ir",
"is",
"je",
"jm",
"jo",
"ke",
"kg",
"kh",
"ki",
"km",
"kn",
"kp",
"kw",
"ky",
"kz",
"la",
"lb",
"lc",
"li",
"lk",
"lr",
"ls",
"lt",
"lu",
"lv",
"ly",
"ma",
"mc",
"md",
"me",
"mf",
"mg",
"mh",
"mk",
"ml",
"mm",
"mn",
"mo",
"mp",
"mq",
"mr",
"ms",
"mt",
"mu",
"mv",
"mw",
"my",
"mz",
"na",
"nc",
"ne",
"nf",
"ng",
"ni",
"no",
"np",
"nr",
"nu",
"nz",
"om",
"pa",
"pe",
"pf",
"pg",
"ph",
"pk",
"pm",
"pn",
"pr",
"ps",
"pt",
"pw",
"py",
"qa",
"re",
"ro",
"rs",
"rw",
"sb",
"sc",
"sd",
"se",
"sg",
"sh",
"si",
"sj",
"sk",
"sl",
"sm",
"sn",
"so",
"sr",
"ss",
"st",
"sv",
"sx",
"sy",
"sz",
"tc",
"td",
"tf",
"tg",
"th",
"tj",
"tk",
"tl",
"tm",
"tn",
"to",
"tt",
"tv",
"tw",
"tz",
"ua",
"ug",
"um",
"uy",
"uz",
"va",
"vc",
"ve",
"vg",
"vi",
"vn",
"vu",
"wf",
"ws",
"ye",
"yt",
"za",
"zm",
"zw"
],
"type": "string",
"description": "Country used to bias search results geographically. The first 19 entries are common defaults; the rest are alphabetical.",
"default": "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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```