Google Maps Area Scanner

Collect public business listings from Google Maps searches. Search by business type, keyword, or map area, then optionally open selected place profiles for additional public details such as hours, photos, reviews, and business attributes.

Each dataset row represents a Google Maps place. The Actor keeps only details visible on the public listing or profile; it does not fill missing values with guesses.

Quick start

Search for coffee shops in a city:

{
  "searchKeywords": ["coffee shops"],
  "locationQuery": "Seattle, WA",
  "maxItems": 20,
  "maxPages": 3
}

Input

Search area and sources

Input	Description
searchKeywords	One or more Maps search phrases (up to 50). queries and searchStringsArray are list aliases; searchQuery accepts one phrase.
locationQuery	Optional city, region, or country appended to generated searches.
lat / lng	Optional map center coordinates; provide both together.
zoom	Optional Maps zoom level (3–21).
radius	Search radius in meters (100–1,000,000), used to derive a zoom level when zoom is not set.
startUrls	Up to 25 public Google Maps search or place URLs. These take precedence over generated searches. sourceUrls, searchUrls, and urls are list aliases; url accepts one URL.
locale	Short locale such as en or en-US. language is a compatibility alias.

When you provide URLs, use Google Maps search or place pages. Generated searches use the selected phrases, location, and map coordinates.

Results and filters

Input	Description
maxItems	Maximum unique places across the run (default 20; maximum 100). maxCrawledPlacesPerSearch is a legacy alias.
page / maxPages	Starting result batch and final batch to inspect (defaults: 1 and 3; maximum 25). Google Maps uses an infinite-scroll feed rather than stable numbered pages.
deduplicate	Remove duplicate places across searches (default true).
sortBy	Order the collected places: recommended source order, rating, review count, or name.
minRating	Keep places with at least this displayed rating (1–5). placeMinimumStars is a legacy alias.
minReviews	Minimum public review count.
categoryFilter	Keep places whose public category contains this text.
closedPlacesFilter	Choose all places, skip closed places, or keep only closed places.

Optional place details

Input	Description
includeDetails	Open public place profiles for richer details (default false).
maxDetailItems	Maximum profiles to open (default 20; maximum 25).
includeOpeningHours	Include weekly and current hours when available (default true).
includeReviews	Include a bounded set of public review snippets (default false).
maxReviewsPerPlace	Maximum review snippets per place (default 5; maximum 20).
includeMedia	Include public business photos when available (default true).
includeAttributes	Include public amenities and accessibility labels when available (default true).

Page display options

Input	Description
renderJavaScript	Use a standard browser to display Maps results. Google Maps feeds usually require JavaScript. useBrowser is a compatibility alias.
proxyConfiguration	Optional Apify proxy settings for browser requests. Use only proxy groups available to your account.

Output

The dataset has one row for each collected place and includes its name and Google Maps URL. Depending on what Maps displays, a row may also contain:

• Place identity: place ID, CID, feature ID, and Knowledge Graph ID.
• Location: address components, Plus Codes, coordinates, and neighborhood.
• Contact and links: website, phone, menu, and other public business links.
• Ratings and reviews: displayed rating and review totals, rating distribution, review summary, topics, and optional review snippets.
• Business details: opening hours, price information, service options, amenities, and popular times.
• Photos and updates: public business photos, photo categories, and owner updates.

Review snippets are only collected when includeReviews is enabled. Reviewer names, profile links, and avatars are not included. Missing yes/no details are left unknown unless Maps explicitly states them.

{
  "title": "Overcast Coffee",
  "canonicalUrl": "https://www.google.com/maps/place/Overcast+Coffee/",
  "placeId": "ChIJ6WqLxohrkFQRfyUGQh-AXmc",
  "categoryName": "Coffee shop",
  "address": "1517 12th Ave Ste 100, Seattle, WA 98122, United States",
  "location": {
    "lat": 47.6146106,
    "lng": -122.3171338
  },
  "website": "https://overcastcoffee.co/",
  "phone": "+1 206-588-2621",
  "totalScore": 4.7,
  "reviewsCount": 314,
  "openingHours": {
    "Monday": "7 AM–6 PM",
    "Tuesday": "7 AM–6 PM"
  },
  "photoCountText": "267+ Photos",
  "photoCountIsApproximate": true
}

The example is abbreviated. Optional values vary by place and by the details selected for a run. Download the dataset from the Apify run page in JSON, CSV, Excel, or another supported format. Run totals and access outcomes are available in the run output.

Limits and troubleshooting

• Google Maps may show different listings and details by search, area, and time.
• Pagination follows visible result batches, so a run can return fewer places than requested.
• If a run has no place records, check the run log and summary for an access boundary, an empty result feed, or a request failure.
• The Actor uses public Google Maps pages and does not bypass CAPTCHAs or other access controls.

Privacy

The Actor sends search phrases, location or coordinates, and locale settings to Google Maps. If you provide start URLs, it visits those public Maps pages. Avoid submitting sensitive information. This Actor is independent and is not affiliated with Google.