Actor picture

Google Maps Scraper

compass/crawler-google-places

Extract data from hundreds of Google Maps businesses and locations in seconds. Get Google Maps data including reviews, images, opening hours, location, popular times & more. Go beyond the limits of the official Google Places API. Download data with Google Maps extractor in JSON, CSV, Excel and more.

No credit card required

Author's avatarCompass
  • Modified
  • Users27,438
  • Runs3,133,990
Actor picture
Google Maps Scraper

🔍 Search term(s)

searchStringsArray

Optional

array

Type what you want to search for as you would write it into the Google Maps search bar, e.g. restaurant or pet shelter. You can also add location here, e.g. restaurant Pittsburgh, but then you will only get around 120 results per search (Google's scrolling limit on a single search).

🗺 Country (scan whole or combine with other geolocation inputs)

countryCode

Optional

string

Set the country where the search should be carried out, e.g., United States. 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 USA or Russia. For these, prefer searching city by city or focus on populated states.

Options:

"us", "af", "al", "dz", "as", "ad", "ao", "ai", "aq", "ag", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "by", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "bv", "br", "io", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "ky", "cf", "td", "cl", "cn", "cx", "cc", "co", "km", "cg", "cd", "ck", "cr", "ci", "hr", "cu", "cy", "cz", "dk", "dj", "dm", "do", "ec", "eg", "sv", "gq", "er", "ee", "et", "fk", "fo", "fj", "fi", "fr", "gf", "pf", "tf", "ga", "gm", "ge", "de", "gh", "gi", "gr", "gl", "gd", "gp", "gu", "gt", "gn", "gw", "gy", "ht", "hm", "va", "hn", "hk", "hu", "is", "in", "id", "ir", "iq", "ie", "il", "it", "jm", "jp", "jo", "kz", "ke", "ki", "kp", "kr", "kw", "kg", "la", "lv", "lb", "ls", "lr", "ly", "li", "lt", "lu", "mo", "mk", "mg", "mw", "my", "mv", "ml", "mt", "mh", "mq", "mr", "mu", "yt", "mx", "fm", "md", "mc", "mn", "me", "ms", "ma", "mz", "mm", "na", "nr", "np", "nl", "an", "nc", "nz", "ni", "ne", "ng", "nu", "nf", "mp", "no", "om", "pk", "pw", "ps", "pa", "pg", "py", "pe", "ph", "pn", "pl", "pt", "pr", "qa", "re", "ro", "ru", "rw", "sh", "kn", "lc", "pm", "vc", "ws", "sm", "st", "sa", "sn", "rs", "sc", "sl", "sg", "sk", "si", "sb", "so", "za", "gs", "ss", "es", "lk", "sd", "sr", "sj", "sz", "se", "ch", "sy", "tw", "tj", "tz", "th", "tl", "tg", "tk", "to", "tt", "tn", "tr", "tm", "tc", "tv", "ug", "ua", "ae", "gb", "um", "uy", "uz", "vu", "ve", "vn", "vg", "vi", "wf", "eh", "ye", "zm", "zw"

📍 City (scan whole or combine with other geolocation inputs)

city

Optional

string

Set the city where the search should be carried out, e.g., Pittsburgh.

Limit the number of places per each search term/URL

maxCrawledPlacesPerSearch

Optional

integer

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.

Language

language

Optional

string

Results details will show in this language.

Options:

"en", "af", "az", "id", "ms", "bs", "ca", "cs", "da", "de", "et", "es", "es-419", "eu", "fil", "fr", "gl", "hr", "zu", "is", "it", "sw", "lv", "lt", "hu", "nl", "no", "uz", "pl", "pt-BR", "pt-PT", "ro", "sq", "sk", "sl", "fi", "sv", "vi", "tr", "el", "bg", "ky", "kk", "mk", "mn", "ru", "sr", "uk", "ka", "hy", "iw", "ur", "ar", "fa", "am", "ne", "hi", "mr", "bn", "pa", "gu", "ta", "te", "kn", "ml", "si", "th", "lo", "my", "km", "ko", "ja", "zh-CN", "zh-TW"

🖼 Limit the number of images (images are very slow)

maxImages

Optional

integer

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

🔗 I want to scrape only place URLs (exclude all other place details)

exportPlaceUrls

Optional

boolean

The results will only show place URLs, but not other details. This is extremely fast and efficient.

Limit number of reviews

maxReviews

Optional

integer

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. Enabling this feature might slow the search down.

One review per row

oneReviewPerRow

Optional

boolean

If checked, the scraper will produce one row of results for each review. The other information about the place is copied into each row. Choose this if you need CSV friendly results.

Only scrape reviews newer than [date]

reviewsStartDate

Optional

string

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

Sort reviews by

reviewsSort

Optional

string

Define in which order reviews should be sorted.

Options:

"newest", "mostRelevant", "highestRanking", "lowestRanking"

Reviews translation

reviewsTranslation

Optional

string

Google automatically adds translated text to the original. You can adjust this behavior here.

Options:

"originalAndTranslated", "onlyOriginal", "onlyTranslated"

Filter reviews by keyword(s)

reviewsFilterString

Optional

string

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.

Reviewer's name

scrapeReviewerName

Optional

boolean

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

Reviewer's ID

scrapeReviewerId

Optional

boolean

Reviewer URL

scrapeReviewerUrl

Optional

boolean

Review ID

scrapeReviewId

Optional

boolean

Review URL

scrapeReviewUrl

Optional

boolean

Response from owner

scrapeResponseFromOwnerText

Optional

boolean

State (scan whole or combine with other geolocation inputs)

state

Optional

string

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

US county (scan whole or combine with other geolocation inputs)

county

Optional

string

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

Postal code (scan whole or combine with other geolocation inputs)

postalCode

Optional

string

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. Remember you can only input one postal code at a time.

Override zoom level

zoom

Optional

integer

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.

🛰 Custom search area (coordinates order must be: [longitude, latitude])

customGeolocation

Optional

object

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.

Match search with place title

searchMatching

Optional

string

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

Options:

"all", "only_includes", "only_exact"

Google Maps URLs

startUrls

Optional

array

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

Proxy configuration

proxyConfig

Required

object

You will need to use Apify proxy or custom proxies. Automatic proxy works very well for Google Maps.

Scrape all places (no search term)

allPlacesNoSearchAction

Optional

string

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

Options:

"all_places_no_search_mouse", "all_places_no_search_ocr"

Max pages per browser

maxPagesPerBrowser

Optional

integer

...hidden...