Google Maps Scraper
Pricing
Pay per usage
Go to Apify Store
Google Maps Scraper
Under maintenance
0.0 (0)
Pricing
Pay per usage
0
2
2
Last modified
2 months ago
Pricing
Pay per usage
0.0 (0)
Pricing
Pay per usage
0
2
2
Last modified
2 months ago
searchStringsArrayarrayOptional
Type what you’d normally search for in the Google Maps search bar, like English breakfast or pet shelter. Aim for unique terms for faster processing. Using similar terms (e.g., bar vs. restaurant vs. cafe) may slightly increase your capture rate but is less efficient.
⚠️ Heads up: Adding a location directly to the search, e.g., restaurant Pittsburgh, can limit you to a maximum of 120 results per search term due to Google Maps' scrolling limit.
You can also use direct place IDs here in the format place_id:ChIJ8_JBApXMDUcRDzXcYUPTGUY.See the detailed description.
locationQuerystringOptional
Define location using free text. Simpler formats work best; e.g., use City + Country rather than City + Country + State. Verify with the OpenStreetMap webapp for visual validation of the exact area you want to cover.
⚠️ Automatically defined City polygons may be smaller than expected (e.g., they don't include agglomeration areas). If you need to define the whole city area, head over to the 📡 Geolocation parameters* section instead to select Country, State, County, City, or Postal code.
For an even more precise location definition (especially when using City name as a starting point), head over to 🛰 Custom search area section to create polygon shapes of the areas you want to scrape. Note that 📍 Location settings always take priority over 📡 Geolocation* (so use either section but not both at the same time).
For guidance and tricks on location definition, check our tutorial.
maxCrawledPlacesPerSearchintegerOptional
Number of results you expect to get per each Search term, Category or URL. The higher the number, the longer it will take.
If you want to scrape all the places available, leave this field empty or use this section 🧭 Scrape all places on the map*.
languageEnumOptional
Results details will show in this language.
"en": string"af": string"az": string"id": string"ms": string"bs": string"ca": string"cs": string"da": string"de": string"et": string"es": string"es-419": string"eu": string"fil": string"fr": string"gl": string"hr": string"zu": string"is": string"it": string"sw": string"lv": string"lt": string"hu": string"nl": string"no": string"uz": string"pl": string"pt-BR": string"pt-PT": string"ro": string"sq": string"sk": string"sl": string"fi": string"sv": string"vi": string"tr": string"el": string"bg": string"ky": string"kk": string"mk": string"mn": string"ru": string"sr": string"uk": string"ka": string"hy": string"iw": string"ur": string"ar": string"fa": string"am": string"ne": string"hi": string"mr": string"bn": string"pa": string"gu": string"ta": string"te": string"kn": string"ml": string"si": string"th": string"lo": string"my": string"km": string"ko": string"ja": string"zh-CN": string"zh-TW": stringDefault value of this property is "en"
categoryFilterWordsarrayOptional
You can limit the places that are scraped based on the Category filter; you can choose as many categories for one flat fee for the whole field. ⚠️ Using categories can sometimes lead to false negatives, as many places do not properly categorize themselves, and there are over 4,000 available categories which Google Maps has. Using categories might filter out places that you’d like to scrape. To avoid this problem, you must list all categories that you want to scrape, including synonyms, e.g., divorce lawyer, divorce attorney, divorce service, etc. See the detailed description.
searchMatchingEnumOptional
Restrict what places are scraped based on matching their name with provided 🔍 Search term. E.g., all places that have chicken in their name vs. places called Kentucky Fried Chicken.
"all": string"only_includes": string"only_exact": stringDefault value of this property is "all"
placeMinimumStarsEnumOptional
Scrape only places with a rating equal to or above the selected stars. Places without reviews will also be skipped. Keep in mind, filtering by reviews reduces the number of places found per credit spent, as many will be excluded.
"two": string"twoAndHalf": string"three": string"threeAndHalf": string"four": string"fourAndHalf": stringDefault value of this property is ""
websiteEnumOptional
Use this to exclude places without a website, or vice versa. This option is turned off by default.
"allPlaces": string"withWebsite": string"withoutWebsite": stringDefault value of this property is "allPlaces"
skipClosedPlacesbooleanOptional
Skip places that are marked as temporary or permanently closed. Ideal for focusing on currently open places.
Default value of this property is false
scrapePlaceDetailPagebooleanOptional
Scrape detail pages of each place the Actor finds. This will slow down the Actor since it needs to open another page for each place individually.
The fields available only when scrapePlaceDetailPage is enabled include: reviewsDistribution, imageCategories, popularTimes fields, openingHours, BusinessConfirmationText, peopleAlsoSearch, reviewsTags, updatesFromCustomers, questionsAndAnswers, tableReservationLinks, orderBy, ownerUpdates, and hotel fields.
This option needs to be enabled if you wish to use any of the options below.
Default value of this property is false
scrapeTableReservationProviderbooleanOptional
Scrape table reservation provider data like name, address, email or phone. This data is present only in restaurants that have blue "RESERVE A TABLE" button
Default value of this property is false
includeWebResultsbooleanOptional
Extract the "Web results" section located at the bottom of every place listing.
Default value of this property is false
scrapeDirectoriesbooleanOptional
Some places (e.g. malls) can have multiple businesses located inside them. This option will scrape inside the "Directory" or "At this place" as per different categories (example here). Turn this toggle on to include those places in your results.
⚠️ Note that that full place details needs to be scraped in order to scrape directories.
Default value of this property is false
maxQuestionsintegerOptional
Set the number of questions per place you expect to scrape. If you fill in 0 or leave the field empty, only the first question and answer will be scraped. To extract all questions, type 999 into the field.
⚠️ Note that some of the fields contain personal data.
Default value of this property is 0
scrapeContactsbooleanOptional
Enrich Google Maps places with contact details extracted from the business website, including business emails and social media profiles (Meta, LinkedIn, X, etc). Price is charged per place at $2 per 1000 places that have a website.
We exclude contacts of big chains: mcdonalds, starbucks, dominos, pizzahut, burgerking, kfc, subway, wendys, dunkindonuts, tacobell.
Default value of this property is false
maximumLeadsEnrichmentRecordsintegerOptional
Enrich your results with detailed contact and company information, including employee names, job titles, emails, phone numbers, LinkedIn profiles, and key company data like industry and number of employees.
This setting allows you to set the maximum number of leads records you want to scrape per each place found on the map (that has a website). By default, it's set to 0 which means that no leads information will be scraped.
⚠️ Note that some of the fields contain personal data. GDPR protects personal data in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your use case is legitimate, please consult an attorney.
We exclude leads of big chains as these are not related to the local places: mcdonalds, starbucks, dominos, pizzahut, burgerking, kfc, subway, wendys, dunkindonuts, tacobell.
Default value of this property is 0
leadsEnrichmentDepartmentsarrayOptional
You can use this filter to include only specific departments (like Sales, Marketing, or C-Suite). Note: This will only work if the ⏩ Add-on: Extract business leads information - Maximum leads per place (maximumLeadsEnrichmentRecords) option is enabled. Please note that some job titles are sometimes miscategorized in the wrong departments.
maxReviewsintegerOptional
Set the number of reviews you expect to get per place, priced at 0.5 per thousand reviews, plus an additional charge of $0.002 per place when scraping reviews, since the Scraper triggers the Extra place details scraped event for each place. To extract all reviews, leave this field empty.
Each output place item can contain maximum 5,000 reviews so in case more reviews are extracted, a duplicate place is stored with the next 5,000 reviews and so on.
⚠️ Enabling this feature might slow the search down.
Default value of this property is 0
reviewsStartDatestringOptional
Either absolute date (e.g. 2024-05-03) or relative date from now into the past (e.g. 8 days, 3 months). JSON input also supports adding time in both absolute (ISO standard, e.g. 2024-05-03T20:00:00) and relative (e.g. 3 hours) formats. Absolute time is always interpreted in the UTC timezone, not your local timezone - please convert accordingly. Supported relative date & time units: minutes, hours, days, weeks, months, years.
⚠️ Heads up: If this parameter is specified, you must choose the 'Newest' sort by value. The reason for this is that with this parameter entered, the actor stops scraping reviews as soon as it finds the first review that's older than the specified date. If the sorting is not set to 'Newest', it might encounter a review older than the specified date before it reaches the desired review count and not scrape the desired amount of reviews.
reviewsSortEnumOptional
Define the order in which reviews should be sorted.
"newest": string"mostRelevant": string"highestRanking": string"lowestRanking": stringDefault value of this property is "newest"
reviewsFilterStringstringOptional
If you enter keywords, only reviews containing those keywords will be scraped. Leave it blank to scrape all reviews.
Default value of this property is ""
reviewsOriginEnumOptional
Select whether you want all reviews (from Google, Tripadvisor, etc.) or only reviews from Google
"all": string"google": stringDefault value of this property is "all"
scrapeReviewsPersonalDatabooleanOptional
This setting allows you to get personal data about the reviewer (their ID, name, URL, and photo URL) and about review (ID and URL).
⚠️ Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.
Default value of this property is true
maxImagesintegerOptional
Set the number of images per place you expect to scrape. Please note that there is an additional charge of $0.002 per place when scraping images, since the Scraper triggers the Extra place details scraped event for each place. To extract all images, leave this field empty. The higher the number, the slower the search.
scrapeImageAuthorsbooleanOptional
Include the author name for each image.
⚠️ Enabling this toggle may slow down processing as it requires fetching information for each image individually.
Default value of this property is false
countryCodeEnumOptional
Set the country where the data extraction should be carried out, e.g., United States.
"us": string"af": string"al": string"dz": string"as": string"ad": string"ao": string"ai": string"aq": string"ag": string"ar": string"am": string"aw": string"au": string"at": string"az": string"bs": string"bh": string"bd": string"bb": string"by": string"be": string"bz": string"bj": string"bm": string"bt": string"bo": string"ba": string"bw": string"bv": string"br": string"io": string"bn": string"bg": string"bf": string"bi": string"kh": string"cm": string"ca": string"cv": string"ky": string"cf": string"td": string"cl": string"cn": string"cx": string"cc": string"co": string"km": string"cg": string"cd": string"ck": string"cr": string"ci": string"hr": string"cu": string"cy": string"cz": string"dk": string"dj": string"dm": string"do": string"ec": string"eg": string"sv": string"gq": string"er": string"ee": string"et": string"fk": string"fo": string"fj": string"fi": string"fr": string"gf": string"pf": string"tf": string"ga": string"gm": string"ge": string"de": string"gh": string"gi": string"gr": string"gl": string"gd": string"gp": string"gu": string"gt": string"gn": string"gw": string"gy": string"ht": string"hm": string"va": string"hn": string"hk": string"hu": string"is": string"in": string"id": string"ir": string"iq": string"ie": string"il": string"it": string"jm": string"jp": string"jo": string"kz": string"ke": string"ki": string"kp": string"kr": string"kw": string"kg": string"la": string"lv": string"lb": string"ls": string"lr": string"ly": string"li": string"lt": string"lu": string"mo": string"mk": string"mg": string"mw": string"my": string"mv": string"ml": string"mt": string"mh": string"mq": string"mr": string"mu": string"yt": string"mx": string"fm": string"md": string"mc": string"mn": string"me": string"ms": string"ma": string"mz": string"mm": string"na": string"nr": string"np": string"nl": string"an": string"nc": string"nz": string"ni": string"ne": string"ng": string"nu": string"nf": string"mp": string"no": string"om": string"pk": string"pw": string"ps": string"pa": string"pg": string"py": string"pe": string"ph": string"pn": string"pl": string"pt": string"pr": string"qa": string"re": string"ro": string"ru": string"rw": string"sh": string"kn": string"lc": string"pm": string"vc": string"ws": string"sm": string"st": string"sa": string"sn": string"rs": string"sc": string"sl": string"sg": string"sk": string"si": string"sb": string"so": string"za": string"gs": string"ss": string"es": string"lk": string"sd": string"sr": string"sj": string"sz": string"se": string"ch": string"sy": string"tw": string"tj": string"tz": string"th": string"tl": string"tg": string"tk": string"to": string"tt": string"tn": string"tr": string"tm": string"tc": string"tv": string"ug": string"ua": string"ae": string"gb": string"um": string"uy": string"uz": string"vu": string"ve": string"vn": string"vg": string"vi": string"wf": string"eh": string"ye": string"zm": string"zw": stringcitystringOptional
Enter the city where the data extraction should be carried out, e.g., Pittsburgh.
⚠️ Do not include State or Country names here.
⚠️ Automatic City polygons may be smaller than expected (e.g., they don't include agglomeration areas). If you need that, set up the location using Country, State, County, City, or Postal code.
For an even more precise location definition (, head over to 🛰 Custom search area section to create polygon shapes of the areas you want to scrape.
statestringOptional
Set a state where the data extraction should be carried out, e.g., Massachusetts (mainly for the US addresses).
countystringOptional
Set the county where the data extraction should be carried out.
⚠️ Note that county may represent different administrative areas in different countries: a county (e.g., US), regional district (e.g., Canada) or département (e.g., France).
postalCodestringOptional
Set the postal code of the area where the data extraction should be carried out, e.g., 10001.
⚠️ Combine Postal code only with 🗺 Country, never with 🌇 City. You can only input one postal code at a time.
customGeolocationobjectOptional
startUrlsarrayOptional
Max 300 results per search URL. Valid format for URLs contains google.com/maps/. This feature also supports uncommon URL formats such as: google.com?cid=***, goo.gl/maps, and custom place list URL.
placeIdsarrayOptional
List of place IDs. You can add place IDs one by one or upload a list using the Bulk edit option. Place ID has format ChIJreV9aqYWdkgROM_boL6YbwA
allPlacesNoSearchActionEnumOptional
Extract all places visible on the map. Use the Override zoom level parameter to select the level of detail. Higher zoom will scrape more places but will take longer to finish. You can test what place pins are visible with a specific zoom by changing the 16z part of the Google Maps URL.
"all_places_no_search_ocr": string"all_places_no_search_mouse": stringDefault value of this property is ""