Google Maps Scraper

Pulls business listings, place details, and reviews from Google Maps into a structured dataset. Useful for competitor research, local directories, lead generation, or any project that needs real place data.

What it does

Search by keyword, collect matching places, and optionally fetch richer detail or reviews for each result.

• Search: Query like "pizza New York" or "hotels London" returns matching places
• Place details: Per-place extras — popular times by hour, full weekly hours, images, description
• Reviews: Customer reviews per place, with sort options

Example use cases

• Build a local business directory for a city
• Track competitor ratings over time
• Collect leads with phone numbers and websites
• Research pricing or business density in a market
• Get GPS coordinates for a mapping project

Input

Field	Description	Default
searchQuery	Search term (e.g., "coffee shops Berlin")	—
placeIds	Direct Place IDs (ChIJ... format)	—
includeDetails	Fetch enriched data per place (popular times, images, description)	true
includeReviews	Collect customer reviews per place	false
maxReviewsPerPlace	Reviews per place	20
reviewSortBy	relevance, newestFirst, ratingHigh, ratingLow	relevance
language	Language code (e.g., "en", "de")	en
country	Country code (e.g., "us", "gb")	us
googleDomain	Google domain (e.g., "google.co.uk")	google.com
location	GPS bias: @lat,lng,zoom (e.g., "@40.71,-74.00,14z")	—
maxItems	Max places to return	20
requestTimeoutSecs	Per-request timeout in seconds	30

Provide either searchQuery or placeIds (or both).

Example input

{
  "searchQuery": "sushi restaurants Tokyo",
  "includeDetails": true,
  "includeReviews": true,
  "maxReviewsPerPlace": 50,
  "reviewSortBy": "newestFirst",
  "language": "en",
  "country": "jp",
  "googleDomain": "google.co.jp",
  "maxItems": 40
}

Output

Each place is one dataset record:

Field	Description
placeId	Google Maps Place ID (ChIJ...)
dataCid	Numeric place identifier
dataId	Hex place identifier (0xHEX:0xHEX)
position	Position in search results
placeName	Business name
rating	Average rating (1.0–5.0)
reviewCount	Total reviews
priceLevel	Price range (e.g., "$10–20")
address	Full street address
phone	Phone number
website	Website URL
placeType	Primary category (e.g., "Restaurant")
placeTypes	All categories
placeDescription	Short editorial description
gpsLatitude / gpsLongitude	Coordinates
isOpen	Currently open (true/false)
openHours	Current hours status (e.g., "Closed · Opens 10 AM")
operatingHours	Full weekly schedule (list of day/time objects)
serviceOptions	Dine-in, takeout, delivery flags
popularTimes	Hourly busyness data by day
images	Thumbnail image URLs
reviews	Customer reviews array (if enabled)
scrapedAt	ISO 8601 timestamp

Example output

{
  "placeId": "ChIJifIePKtZwokRVZ-UdRGkZzs",
  "placeName": "Joe's Pizza Broadway",
  "rating": 4.4,
  "reviewCount": 25442,
  "priceLevel": "$10-20",
  "address": "1435 Broadway, New York, NY 10018",
  "phone": "(646) 559-4878",
  "website": "https://www.joespizzanyc.com/",
  "placeType": "Pizza restaurant",
  "placeTypes": ["Pizza restaurant", "Pizza delivery", "Restaurant"],
  "placeDescription": "Classic NYC slice shop offering New York-style slices and pies.",
  "gpsLatitude": 40.7549,
  "gpsLongitude": -73.9864,
  "isOpen": false,
  "openHours": "Closed · Opens 10 AM",
  "operatingHours": [
    { "monday": "10 AM–3 AM" },
    { "tuesday": "10 AM–3 AM" },
    { "friday": "10 AM–5 AM" }
  ],
  "serviceOptions": { "dine_in": true, "takeout": true, "delivery": false },
  "popularTimes": {
    "monday": [
      { "time": "10 AM", "busyness_score": 20 },
      { "time": "12 PM", "busyness_score": 75 }
    ]
  },
  "images": [
    "https://lh3.googleusercontent.com/..."
  ],
  "reviews": [
    {
      "reviewRating": 5,
      "reviewText": "Best pizza slice in New York. Period.",
      "reviewerName": "Sarah M.",
      "reviewDate": "2 months ago",
      "isLocalGuide": false,
      "likes": 12
    }
  ],
  "scrapedAt": "2025-06-01T14:32:00+00:00"
}

Notes

• Search returns up to 20 results per page, 120 max total
• Reviews paginate automatically up to your maxReviewsPerPlace limit
• includeDetails: true makes one extra request per place
• Use location as @latitude,longitude,zoom to target a specific area (e.g., @48.8566,2.3522,13z for Paris)
• placeIds and searchQuery can be used together — duplicate place IDs are skipped automatically