Google Maps Geocoding Scraper

Resolve public Google Maps searches, place URLs, addresses, or coordinate pairs into structured place records. Results can include business identity, coordinates, address, contact details, ratings, opening hours, services, and photos when Google Maps displays them.

Address and coordinate inputs search for the supplied place or location. They do not automatically find nearby businesses. A reverse coordinate result may contain only coordinates or a Plus Code when Maps does not show a street address.

Quick start

Search for public Maps listings:

{
  "queries": ["independent coffee shops in Seattle"],
  "maxItems": 10,
  "page": 1,
  "maxPages": 2
}

To resolve addresses or coordinates, use addresses or coordinates instead of a search phrase.

Input

Search sources

Input	Description
startUrls	Up to 25 public Google Maps search or place URLs. placeUrls, sourceUrls, searchUrls, and urls are aliases.
queries	Public Maps search phrases. query and searchQuery accept one phrase.
addresses	Up to 100 public addresses to search on Google Maps.
coordinates	Up to 100 coordinate pairs, each with latitude and longitude. Latitude must be -90 to 90; longitude -180 to 180.

Place URLs are treated as the requested profile source. Supplied URLs take precedence over generated searches.

Results and filters

Input	Description
maxItems	Maximum unique business records across the run (default 10; maximum 100).
page / maxPages	Starting result batch and maximum batches per search (defaults: 1 and 3). Page supports offsets up to 100; maxPages supports up to 25 batches.
deduplicate	Keep one row per place identity (default true).
keyword	Keep records whose visible name, category, address, or description contains this text.
category	Keep records whose primary category contains this text.
country	Keep records whose visible place text contains this country.
minRating / minReviewCount	Minimum visible rating (0–5) and review count. Places without the values do not pass the filters.
sortBy	Keep Maps relevance order, or sort by rating, review count, or name.

Optional profile details

Input	Description
includeDetails	Open selected Maps profiles for additional contact, hours, and business attributes (default false).
maxDetailItems	Maximum profiles to open (default 3; maximum 50).
includeMedia	Include visible business photos and image details (default true).

Page settings

Input	Description
useBrowser	Render dynamic Maps pages in a standard browser (default true). When disabled, only information available in static HTML can be collected.
proxyConfiguration	Optional Apify proxy settings for browser navigation.

Dataset

Each row includes the place name and canonical Google Maps URL. Depending on the source, a record may also include:

• Place identity: place ID, feature ID, and Knowledge Graph ID.
• Location: latitude, longitude, coordinate pair, Plus Code, address, and address parts when the displayed address can be parsed clearly.
• Contact: phone number, website, and website domain.
• Public profile: category, description, rating, review count, price range, hours, current status, service and accessibility attributes.
• Links and images: menu, ordering, and reservation links, plus public business photos and photo categories.
• Coordinate source: whether coordinates came from the public Maps place URL.

{
  "name": "Example Cafe",
  "normalizedName": "example cafe",
  "primaryCategory": "Coffee shop",
  "categories": ["Coffee shop"],
  "address": "10 Example Street, Seattle, WA 98101, United States",
  "formattedAddress": "10 Example Street, Seattle, WA 98101, United States",
  "latitude": 47.61,
  "longitude": -122.33,
  "location": {
    "lat": 47.61,
    "lng": -122.33
  },
  "plusCode": "8R84+2X Seattle",
  "phone": "+1 206-555-0100",
  "website": "https://example.com/",
  "rating": 4.7,
  "reviewCount": 314,
  "currentStatus": "Open · Closes 5 pm",
  "openingHours": [
    { "day": "Monday", "hours": "7 am–5 pm" }
  ],
  "canonicalUrl": "https://www.google.com/maps/place/Example+Cafe/"
}

The example is illustrative; Maps may not expose every field for each place. If details are enabled, records can include expanded hours, accessibility, service options, and business attributes. Download the dataset from the Apify run page in JSON, CSV, Excel, or another supported format. Run totals and source outcomes are available in the run output.

Limits and troubleshooting

Google Maps may show different results by query, location, and time. Result cards can be brief, and some place details may require a rendered page. If a run is empty or partial, check the run log and summary for access boundaries or unavailable pages.

The Actor uses public Google Maps pages and does not bypass CAPTCHAs or other access controls. A failed or empty source does not create a dataset row.

Privacy

The Actor sends search phrases, addresses, coordinates, and supplied Maps URLs to Google Maps. Avoid submitting sensitive locations. This independent Actor is not affiliated with Google.