Google Maps,
read at the
source.
I built a scraper that turns a Google Maps search into clean business records: name, address, phone, website, rating, hours and coordinates.
Google Maps has no public API for this business data, so mine reads the internal protobuf endpoint directly, over plain HTTP. No browser.
How it works.
From a search phrase to streamed records- A query becomes a gridI resolve the place in the query to an area and cut that area into a grid of cells. The zoom level sets how fine the grid is, so a whole city is covered cell by cell instead of stopping at the first page of results.
- The internal endpoint, directlyEach cell is one request to the same internal endpoint the Maps web app calls. It answers in protobuf’s wire format, not JSON. I call it over HTTP with aiohttp: no browser, no API key.
- Decoded, then de-duplicatedI decode the nested messages into typed fields: name, address, category, rating, review count, coordinates and place_id. Neighbouring cells overlap, so every place is de-duplicated by place_id and hex_id before it goes further.
- Enriched with detailsWith details on, each new place gets a second request for its hours, phone, website, amenities, plus code and closed status. Reviews are a separate pass you switch on when you need them.
- Streamed, checkpointed, pacedRecords stream out asynchronously as they are decoded. Progress is checkpointed so a long run resumes instead of starting over, and the request rate adapts as it goes.
The recorded run.
Recorded, not liveRecorded real run · 7 October 2026 · query “restaurants in Los Angeles, CA” · 500 of 1,500 rows shown
Real output of the published actor, recorded by its author. Business listings are public information from Google Maps. Not live; ratings and hours are as of the run date.
I ran Google Maps Scraper with place details on and reviews off. Photos are left out of this page: they are Google-hosted image URLs, and I don’t re-serve them. “Open now” uses the current time in Los Angeles, because the recorded hours are local to Los Angeles.
Loading 500 recorded places…
Choose a place
Pick a dot on the map or a row in the list to see the full record.
Up and down arrow keys move through the list.
Inputs.
The actor’s input fields, and what this run usedThese are the real input fields of Google Maps Scraper on the Apify Store. The run above set four of them; everything else stayed at its default.
The run used only search and place details. The other fields turn the same records into leads. Email finding visits each business’s own website for addresses. Social finding pulls its Facebook, Instagram, LinkedIn, X, YouTube, TikTok and WhatsApp links. People finding lists the named staff a site publishes, with their own email, phone or LinkedIn. Ad intelligence looks the business up in the public Meta Ad Library and in Google’s Ads Transparency Center. All four are experimental add-ons, off by default.
Set in this runDefault
What to search for
queryWhat you would type in the Maps search box, such as “dentists in Miami”. The location is detected from the phrase.Set in this run: “restaurants in Los Angeles, CA”searchQueriesSeveral searches in one run, merged and de-duplicated by place.emptystartUrlsGoogle Maps place or search links to start from instead of a phrase.emptycustomGeolocationAn exact area: a point and radius, or a GeoJSON polygon.empty
Results and detail
maxResultsUpper limit on businesses; 0 collects everything found in the area.Set in this run: 1500languageTwo-letter language code for the result text.enzoomGrid fineness from 1 to 21; higher means smaller cells.13includeDetailsThe second request per place: hours, phone, website, amenities.Set in this run: onincludePhotosUp to 10 photo URLs per place.onincludePlaceExtrasAmenities, plus code and permanently-closed status.onincludePopularTimesThe weekly busy histogram. Experimental: Google rarely includes it in the HTTP response.off
Reviews
includeReviewsEach place’s Google reviews: author, rating, date, text and owner reply.Set in this run: offreviewsLimitReviews per business when reviews are on.5minReviewRatingKeep reviews at or above this many stars; 0 keeps all.0reviewKeywordKeep reviews whose text contains a phrase.emptyreviewsSortNewest first, or Google’s most relevant order.newest
Lead enrichment, experimental
includeEmailsVisits each business website and its contact pages for email addresses.offincludeSocialsSocial profile links found on each business website.offemailOnlyKeep only businesses with an email address.offsocialOnlyKeep only businesses with a social profile.offonlyWithWebsiteKeep only businesses with a real website.offonlyWithoutWebsiteKeep only businesses without one.offmaxPagesPerSitePages read on each website during enrichment.4
People and contacts, experimental
includePersonnelThe people a business’s own site names: name, title, and their published email, phone or LinkedIn.offmaxContactsPerBusinessMost contacts kept per business, highest confidence first.10personnelMinConfidenceDrop contacts below this confidence tier.lowonlyWithPersonnelKeep only businesses with a named person.off
Ad intelligence, experimental
includeMetaAdsWhether the business runs Facebook or Instagram ads, from the public Meta Ad Library.offincludeGoogleAdsWhether it runs Google ads, from Google’s Ads Transparency Center.offonlyRunningAdsKeep only businesses that are advertising now.offadCountryCountry for the ad lookups.US
Proxy
proxyConfigurationHow requests reach Google.not shownproxyUrlAn optional custom proxy instead.not shown
Run it yourself.
Hosted, or on your own machine- Google Maps Scraper on the Apify Store The hosted version: the inputs above as a form, runs in the cloud, exports CSV, Excel or JSON. Pay per event.434 users · Apify Store figures, 30 Oct 2026 Open on Apify
- GoogleMapsCollector, the Python package The open-source engine for your own machine: a CLI and an async Python API, with grid search, checkpoints and streaming output. Version 2.0.0. Repository
Honest limits
- Recorded on 7 October 2026Ratings, review counts and hours are what Google showed that day. I don’t refresh this page.
- Reviews were offI ran it with review collection switched off, so the records carry review counts but no review text.
- Photos omittedThe actor returns Google-hosted photo URLs. I left them out of this page rather than re-serve Google’s images.
- 500 of 1,500 rowsThe run returned 1,500 places; this page carries 500 of them to keep it light.