Google Maps Scraper

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.

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, US 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.

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*.

Results details will show in this language.

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.

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.

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.

Use this to exclude places without a website, or vice versa. This option is turned off by default.

Skip places that are marked as temporary or permanently closed. Ideal for focusing on currently open places.

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.

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

Extract the "Web results" section located at the bottom of every place listing.

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.

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.

Enrich Google Maps places with contact details including emails, social media profiles (Meta, LinkedIn, X, etc)at $2 per 1000 results.

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.

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.

Define the order in which reviews should be sorted.

If you enter keywords, only reviews containing those keywords will be scraped. Leave it blank to scrape all reviews.

Select whether you want all reviews (from Google, Tripadvisor, etc.) or only reviews from Google

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.

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.

Include the author name for each image.

⚠️ Enabling this toggle may slow down processing as it requires fetching information for each image individually.

Set the country where the data extraction should be carried out, e.g., United States.

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, US 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.

Set a state where the data extraction should be carried out, e.g., Massachusetts (mainly for the US addresses).

⚠️ Always combine State with other Location types, otherwise you will scrape the whole state!

Set the US county where the data extraction should be carried out, e.g., Madison.

⚠️ Always combine US county with other Location types, otherwise you will scrape the whole county!

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.

Use this field to define the exact search area if other search area parameters don't work for you. See readme or our guide for details.

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.

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.