Google Maps Scraper

Type what you want to search for as you would write it into the Google Maps search bar, e.g. restaurant or pet shelter. The search terms should be unique because each requires the same processing time. Using similar terms is less efficient because of overlap but can slightly increase the capture rate (e.g. bar vs restaurant vs cafe).
Putting location directly into search terms, e.g. restaurant Pittsburgh, is not recommended because you will only get max 120 results per search (Google's scrolling limit on a single search) but it can be done for speed. You can also use direct place IDs here in the format place_id:ChIJ8_JBApXMDUcRDzXcYUPTGUY

Free text location definition. Generally, simpler locations work better, e.g. prefer using city and country, not city, country and state. Use OpenStreeMap webapp for visual validation of the exact covered area. If you use Zip codes, you must use them with country name (not city name!). You can always fallback to Geolocation section where you can select country, state, county, city and postalCode. Keep in mind that Location has always preference of these.

This is the maximum number of results you will obtain for each search term or URL.
A higher number will take longer to scrape. If you want to scrape all places available, set this value to 9999999. If the number is less than 200, deeperCityScrape will be disabled

Results details will show in this language.

Maximum number of images per place. If you fill in '0' or leave the field empty, no images will be scraped. To extract all images, type 99999 into the field. The higher the number, the slower the search.

The results will only show data from the search page, but no other details. This speeds up the scrape significantly. For each place it extracts ONLY isAdvertisement, title, placeId, location, address, neighborhood, street, city, postalCode, state, countryCode, categoryName, categories, url

Extract the bottom "Web results" section of place data. It slightly increases compute and proxy usage.

Some places (e.g. malls) can have multiple places located inside them. Turn this option to include those places in your results

Enables to extract significantly more places from larger areas because each city inside the region is more focused. It also helps the scraper to skip areas without any population like deserts, mountains or oceans. This is especially important for countries with larger areas without population like Australia or Canada.

Be aware that enabling this feature increases the runtime (by extracting more places). This feature will likely become a default setting in the near future but is currently opt-in to allow for smooth transition.

This is the maximum number of reviews per place. If you fill in '0' or leave the field empty, no reviews will be scraped. To extract all reviews, type '99999' into the field. Each output place item can contain maximum 5000 reviews so in case more reviews are extracted, a duplicate place is stored with the next 5000 reviews and so on. Enabling this feature might slow the search down.

Format should be YYYY-MM-DD, e.g., 2022-02-20

Define the order in which reviews should be sorted.

If you fill in a keyword(s), only reviews containing the keyword(s) will be scraped. If you leave the field empty, all reviews will be scraped.

If checked, the scraper will extract the reviewer's name - please, keep in mind the above personal data warning.

Maximum number of questions per place. If you fill in '0' or leave the field empty, only first question and answer will be scraped. To extract all questions, type 999 into the field.

You don't need to set this parameter. A good value is chosen automatically based on the chosen location, see readme for more info. Changing the zoom manually may cause the cost to vary significantly.

Set the country where the search should be carried out, e.g., United States. Warning: if used without city or other geolocation parameters, the scraper will scan the whole country!
Currently, the scraper doesn't work well for full-country searching of sparsely populated countries like the United States or Russia. For these, search city by city or focus on populated states.

Enter the city where the search should be carried out, e.g., Pittsburgh. Warning: just add a single city and don't add state or country here.

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

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

Set the postal code of the area where the search should be carried out, e.g., 10001. Select a country as well to ensure the correct postal code is used.
Warning: 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.

You can filter places by categories. It can be a general one, e.g. restaurant, which would accept all places with categories containing restaurant e.g. Mexican restaurant, or it can be more specific, e.g. indian restaurant accepts only places with category Indian restaurant. You can also specify categories only instead of seach terms but you can use both as well. Filtering by categories currently works only for english language. Here you can see list of all supported categories.

Restrict what places are scraped based on matching their title with provided search term

Only scrape places with a rating of at least the number of selected stars. Places without any reviews are skipped as well. Be aware that limiting by reviews lowers places found per credits spent because many places are discarded.

Skips places that are marked as temporary or permanently closed. This is useful if you want to get only places that are currently open.

Copy a Google Maps URL and paste it here. Leave empty if you have already filled the Search term field. The only valid format for URLs contains either /maps/search or /maps/place, e.g., https://www.google.com/maps/search/falafel+new+york/..

Will scrape all places seen on the map. This depends on a lot of the zoom so for more places, increase the zoom. Doesn't work together with URLs