Google Places Scraper

Find any business or point of interest on Google Maps — by free-text query or by coordinates and radius — and export the full place record: name, address, coordinates, rating, phone, website, hours, and reviews.

What you get

• One dataset row per place with placeId, display name, formatted address, latitude/longitude, place types, rating, review count, price level, website, phone numbers, business status, opening hours, and Google Maps URL
• Optional reviews — up to 5 per place with author, rating, text, and timestamps
• Two search modes — Text (free text + optional location bias) or Nearby (lat/lng + radius + types)
• Auto-pagination — Text search fetches up to 60 places per run; resume the next page via NEXT_PAGE_ID
• Localized — request results in any language and bias by region code
• Wall-clock-safe — saves the resume cursor 60s before the actor times out so large runs don't lose progress

Use cases

• Local business directory — pull every coffee shop, dentist, or gym in a city
• Lead generation — extract phone numbers, websites, and addresses for outbound campaigns
• Competitive intelligence — track ratings and review counts of competitors in a region
• Real estate / site selection — count amenities within a radius of a candidate location
• Travel guides & directory sites — build curated lists with addresses, hours, and Google Maps links

How to use

1. Pick a Search mode:
   • Text — type a query like "coffee shops in Brooklyn" or "best ramen Tokyo". Optionally bias with latitude/longitude/radius.
   • Nearby — set latitude, longitude, radius (meters), and optional included place types.
2. (Optional) Set Language code (en, es, fr, …) and Region code (us, gb, de, …) for localized results.
3. Set Max items — Text mode paginates up to 60; Nearby returns up to 20 in a single call.
4. (Optional) Toggle Include reviews to add up to 5 reviews per place.
5. Run — every place appears as its own dataset row.
6. To fetch more Text-search results, copy NEXT_PAGE_ID from the Key-value store tab and paste it into Page ID on the next run. If NEXT_PAGE_ID is null, the list is exhausted.

Place types reference

Use the place-type tokens documented by Google — common ones include restaurant, cafe, bar, gym, hair_care, lodging, tourist_attraction, gas_station, pharmacy, dentist, doctor, hospital, school, bank, atm, supermarket, clothing_store, electronics_store. Stack multiple types in Included place types to broaden the search.

Output schema

Field	Type	Description
placeId	string	Stable Google Place ID
displayName	string	Place name
formattedAddress	string	Full address
latitude / longitude	number	Coordinates
types	string[]	All Google place types
primaryType	string	Primary place type
rating	number	1–5 average rating
userRatingCount	number	Total ratings
priceLevel	string	PRICE_LEVEL_FREE … PRICE_LEVEL_VERY_EXPENSIVE
websiteUri	string	Business website
internationalPhoneNumber	string	E.164 phone
nationalPhoneNumber	string	National-format phone
businessStatus	string	OPERATIONAL, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY
weekdayDescriptions	string[]	Human-readable opening hours
googleMapsUri	string	Canonical Google Maps URL
iconMaskBaseUri	string	Icon for the place type
iconBackgroundColor	string	Hex color for the icon mask
reviews	array	Up to 5 reviews (when Include reviews is on)

Tips

• Text mode is the easiest way to get a city-wide list — Google handles geographic interpretation for you.
• Nearby mode is more deterministic — useful when you want every place inside a precise radius.
• Setting Include reviews materially increases cost-per-place — only enable when you actually need them.
• Phone, website, and hours aren't filled in on every place — small businesses often lack them.
• For large multi-city pulls, run one query per city and resume each via NEXT_PAGE_ID.