📍 Google Maps Scraper

Extract rich, structured data from any Google Maps place — business names, addresses, phone numbers, websites, ratings, reviews, images, opening hours, popular times, contact details, and much more. Supports keyword searches, direct place URLs, Place IDs, and custom GeoJSON area searches.

---

🔍 What data does Google Maps Scraper extract?

Category	Fields
🏷️ Identity	Title, subtitle, description, category, categories, Place ID
📍 Location	Full address, street, city, state, postal code, country, coordinates (lat/lng), Plus Code
☎️ Contact	Phone (formatted + raw), website URL
⭐ Rating	Average score, review count, review distribution (1–5 stars)
📝 Reviews	Reviewer name, photo, star rating, text, date, owner response, images, Local Guide status
🖼️ Images	Full-resolution image URLs, optional author attribution
🕐 Hours	Opening hours per day
📊 Popularity	Popular times histogram (by hour/day), live occupancy text
➕ Attributes	Service options, accessibility, atmosphere, dining, payments, amenities
🔗 Social	Facebook, Instagram, LinkedIn, Twitter, YouTube, TikTok, Pinterest (from website)
📧 Contact enrichment	Emails, extra phone numbers from the place''s own website
❓ Q&As	Community questions and answers
🍽️ Restaurant extras	Price range, table reservation provider, food delivery links
🏨 Hotel extras	Star rating, description
🔍 Discover	"People also search for" related places
🌐 Web results	External web results shown in the place listing
🤖 Competitor analysis	Scored rankings, strengths/weaknesses, interactive HTML map

---

🚀 Quick Start

1. Search by keyword + location

{
  "searchStringsArray": ["pizza restaurant"],
  "locationQuery": "Manhattan, New York, USA",
  "maxCrawledPlacesPerSearch": 50,
  "maxReviews": 5
}

2. Scrape specific places by URL

{
  "startUrls": [
    { "url": "https://www.google.com/maps/place/Eiffel+Tower/@48.8583701,2.2922926,17z" }
  ],
  "maxReviews": 20,
  "maxImages": 10,
  "scrapePlaceDetailPage": true
}

3. Scrape by Place ID

{
  "placeIds": ["ChIJN1t_tDeuEmsRUsoyG83frY4"],
  "scrapePlaceDetailPage": true,
  "maxReviews": 100
}

4. Custom GeoJSON area (polygon)

{
  "searchStringsArray": ["coffee shop"],
  "customGeolocation": {
    "type": "Polygon",
    "coordinates": [[
      [-74.02, 40.70], [-73.97, 40.70],
      [-73.97, 40.73], [-74.02, 40.73],
      [-74.02, 40.70]
    ]]
  }
}

5. Lead generation — scrape contacts from websites

{
  "searchStringsArray": ["law firm"],
  "locationQuery": "Chicago, USA",
  "maxCrawledPlacesPerSearch": 100,
  "scrapeContacts": true
}

---

📥 Input Parameters

🔎 Search & Location

Parameter	Type	Default	Description
searchStringsArray	string[]	—	Search keywords (e.g. ["pizza", "burger"]). Each runs a separate search.
locationQuery	string	—	Location in free text (e.g. "New York, USA" or "Paris, France"). Combined with search terms.
language	string	"en"	Language for results — ISO 639-1 code ("en", "fr", "de", etc.)
countryCode	string	—	ISO country code for geolocation ("US", "GB", "DE", etc.)
city	string	—	City name for precise geolocation
state	string	—	State or province for geolocation
postalCode	string	—	Postal/ZIP code (best combined with countryCode)
customGeolocation	object	—	GeoJSON geometry: Point (with radiusKm), Polygon, or MultiPolygon
maxCrawledPlacesPerSearch	integer	50	Max places per search query (1 – 10,000)
startUrls	object[]	—	Direct Google Maps URLs to scrape (bypasses keyword search)
placeIds	string[]	—	Google Place IDs to scrape directly (e.g. ChIJ...)

🔽 Filtering

Parameter	Type	Default	Description
categoryFilterWords	string[]	—	Include only places whose category contains one of these words
searchMatching	string	"all"	all · only_includes (name contains search term) · only_exact
placeMinimumStars	string	—	Minimum rating: two, twoAndHalf, three, threeAndHalf, four, fourAndHalf
website	string	"allPlaces"	allPlaces · withWebsite · withoutWebsite
skipClosedPlaces	boolean	false	Skip permanently or temporarily closed places

📝 Reviews

Parameter	Type	Default	Description
maxReviews	integer	0	Reviews per place (0 = none, 99999 = all available)
reviewsSort	string	"newest"	Sort order: newest · mostRelevant · highestRanking · lowestRanking
reviewsStartDate	string	—	Only reviews after this date (YYYY-MM-DD or e.g. "3 months")
reviewsFilterString	string	—	Keyword filter — only reviews containing this phrase
reviewsOrigin	string	"all"	all sources or google only
scrapeReviewsPersonalData	boolean	true	Include reviewer name, photo, and profile URL

🖼️ Images

Parameter	Type	Default	Description
maxImages	integer	0	Images per place (0 = none, 99999 = all available)
scrapeImageAuthors	boolean	false	Include image author name and Google Maps profile URL

🔍 Detail Page & Extras

Parameter	Type	Default	Description
scrapePlaceDetailPage	boolean	false	Scrape the full detail page. Required for: opening hours, popular times, Q&As, amenities
maxQuestions	integer	0	Q&A pairs to extract per place (0 = none)
scrapeTableReservation	boolean	false	Extract table reservation provider (Resy, OpenTable, etc.)
scrapeOrderOnline	boolean	false	Extract food delivery / order-online providers
includeWebResults	boolean	false	Include external web results shown in the listing
scrapeContacts	boolean	false	Visit each place website to extract emails, phones, and social media links

🤖 Competitor Analysis

Parameter	Type	Default	Description
enableCompetitorAnalysis	boolean	false	After scraping, generate a scored competitor report + interactive HTML map

🛡️ Proxy

Parameter	Type	Description
proxyConfiguration	object	Proxy settings. Apify residential proxies recommended for Google Maps at scale.

---

📤 Output Schema

Each scraped place is saved as one JSON item in the dataset:

{
  "title": "Joe's Pizza",
  "subTitle": "Pizza restaurant",
  "description": "Classic NYC slice joint since 1975.",
  "price": "Under $10",
  "categoryName": "Pizza restaurant",
  "categories": ["Pizza restaurant", "Italian restaurant"],

  "address": "7 Carmine St, New York, NY 10014",
  "neighborhood": "Greenwich Village",
  "street": "7 Carmine St",
  "city": "New York",
  "state": "NY",
  "postalCode": "10014",
  "countryCode": "US",
  "lat": 40.7303,
  "lng": -74.0019,
  "plusCode": "Q22F+MF New York",

  "googleMapsUrl": "https://www.google.com/maps/place/...",
  "placeId": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
  "website": "https://joespizzanyc.com",
  "phone": "(212) 255-3946",
  "phoneUnformatted": "(212) 255-3946",

  "totalScore": 4.5,
  "reviewsCount": 4200,
  "reviewsDistribution": {
    "oneStar": 50, "twoStar": 30, "threeStar": 120,
    "fourStar": 900, "fiveStar": 3100
  },

  "permanentlyClosed": false,
  "temporarilyClosed": false,
  "claimStatus": null,

  "openingHours": [
    { "day": "Monday", "hours": "10 AM–11 PM" },
    { "day": "Tuesday", "hours": "10 AM–11 PM" }
  ],

  "popularTimesHistogram": {
    "Mo": [{ "hour": 9, "occupancyPercent": 20 }, { "hour": 12, "occupancyPercent": 75 }],
    "Fr": [{ "hour": 18, "occupancyPercent": 95 }]
  },
  "popularTimesLiveText": "Usually not too busy",

  "additionalInfo": {
    "Service options": [{ "Dine-in": true }, { "Takeout": true }, { "Delivery": false }],
    "Accessibility": [{ "Wheelchair accessible entrance": true }],
    "Payments": [{ "Credit cards": true }, { "NFC mobile payments": true }]
  },

  "thumbnailUrl": "https://lh3.googleusercontent.com/...",
  "imageUrls": ["https://lh3.googleusercontent.com/..."],
  "images": [{ "imageUrl": "...", "authorName": "Alice Johnson", "authorUrl": "..." }],

  "reviews": [{
    "reviewId": "ChdDSUhNMG9nS0...",
    "reviewerName": "Bob Smith",
    "reviewerPhotoUrl": "https://lh3.googleusercontent.com/...",
    "reviewerNumberOfReviews": 42,
    "isLocalGuide": true,
    "stars": 5,
    "text": "Best pizza in NYC, no contest!",
    "publishAt": "2 months ago",
    "publishedAtDate": "2024-06-01",
    "likesCount": 12,
    "responseFromOwnerText": "Thank you so much!",
    "responseFromOwnerDate": "a month ago",
    "reviewImageUrls": [],
    "reviewDetailedRating": { "Food": 5, "Service": 5, "Atmosphere": 4 }
  }],

  "questions": [{ "question": "Is parking available?", "answer": "Street parking nearby." }],
  "peopleAlsoSearch": [{ "title": "John's Pizza", "totalScore": 4.3, "reviewsCount": 980 }],

  "reserveTableUrl": "https://www.google.com/maps/reserve/v/dine/...",
  "tableReservationProvider": "OpenTable",
  "orderOnlineUrls": [{ "provider": "Uber Eats", "url": "https://ubereats.com/..." }],

  "emails": ["contact@joespizzanyc.com"],
  "phones": ["+1 212-255-3946"],
  "facebook": "https://facebook.com/joespizzanyc",
  "instagram": "https://instagram.com/joespizzanyc",
  "linkedin": null,
  "twitter": "https://twitter.com/joespizzanyc",
  "youtube": null,
  "tiktok": null,
  "pinterest": null,

  "searchString": "pizza restaurant",
  "rank": 1,
  "scrapedAt": "2026-08-19T00:00:00.000Z"
}

---

📍 Geolocation Options

Free-text location (simplest)

Type any location into locationQuery:

• "New York, USA" · "Paris, France" · "10001" (postal code)

Structured geolocation (more precise)

Combine countryCode, state, city, postalCode for pinpoint accuracy.

GeoJSON custom area (most flexible)

Circle — search within a radius:

{ "type": "Point", "coordinates": [-73.9857, 40.7484], "radiusKm": 5 }

Polygon — custom drawn area (first and last coordinate must match to close the shape):

{
  "type": "Polygon",
  "coordinates": [[
    [-0.3228, 51.5972], [-0.3150, 51.3880],
    [0.0605, 51.3892], [0.0519, 51.6004],
    [-0.3228, 51.5972]
  ]]
}

MultiPolygon — multiple disconnected areas in one run:

{
  "type": "MultiPolygon",
  "coordinates": [
    [[[-74.02,40.70],[-73.97,40.70],[-73.97,40.73],[-74.02,40.73],[-74.02,40.70]]],
    [[[2.30,48.84],[2.37,48.84],[2.37,48.88],[2.30,48.88],[2.30,48.84]]]
  ]
}

💡 Use geojson.io to draw your area visually and copy the GeoJSON output.

⚠️ GeoJSON uses longitude first, then latitude — opposite of Google Maps.

---

🎯 Common Use Cases

🧲 Lead generation

{
  "searchStringsArray": ["dentist", "dental clinic"],
  "locationQuery": "Austin, Texas, USA",
  "maxCrawledPlacesPerSearch": 200,
  "scrapeContacts": true,
  "website": "withWebsite",
  "placeMinimumStars": "three"
}

🏆 Competitor research

{
  "searchStringsArray": ["italian restaurant"],
  "locationQuery": "Rome, Italy",
  "maxCrawledPlacesPerSearch": 50,
  "maxReviews": 20,
  "enableCompetitorAnalysis": true
}

📅 Monitor recent reviews

{
  "startUrls": [{ "url": "https://www.google.com/maps/place/Your+Business/..." }],
  "maxReviews": 50,
  "reviewsSort": "newest",
  "reviewsStartDate": "1 month"
}

🍽️ Full restaurant profile

{
  "searchStringsArray": ["sushi restaurant"],
  "locationQuery": "San Francisco, USA",
  "maxCrawledPlacesPerSearch": 30,
  "scrapePlaceDetailPage": true,
  "maxReviews": 10,
  "maxImages": 5,
  "scrapeTableReservation": true,
  "scrapeOrderOnline": true
}

---

⭐ Reviews in Detail

Field	Description
reviewId	Unique Google review ID
reviewerName	Reviewer's display name
reviewerPhotoUrl	Profile photo URL
reviewerNumberOfReviews	Total reviews by this person
isLocalGuide	Whether reviewer is a Google Local Guide
stars	1–5 star rating
text	Full review text
publishAt	Relative time ("2 months ago")
publishedAtDate	Absolute date
likesCount	"Helpful" likes count
responseFromOwnerText	Owner's reply
reviewImageUrls	Photos attached to the review
reviewDetailedRating	Per-category ratings (Food, Service, Atmosphere)

Sort: newest · mostRelevant · highestRanking · lowestRanking

Date filter: reviewsStartDate: "3 months" or "2024-01-01"

Keyword filter: reviewsFilterString: "parking" → only reviews mentioning "parking"

---

📧 Contact Enrichment

When scrapeContacts: true, the scraper visits each place's website and extracts:

• 📧 Emails — from page text and mailto: links
• ☎️ Extra phones — beyond the Google Maps listing
• 📱 Social media: Facebook, Instagram, LinkedIn, Twitter/X, YouTube, TikTok, Pinterest

Uses only publicly visible data on each business's own website. No paid APIs required.

---

🤖 Competitor Analysis

Enable with enableCompetitorAnalysis: true. After scraping completes, the actor:

1. Scores each place (0–100 composite): rating 50% + review volume 30% + data completeness 20%
2. Ranks all places from strongest to weakest
3. Identifies signals per place: exceptional rating, high review volume, missing website, etc.
4. Produces a market summary: competitive stats, gaps, and opportunities
5. Generates an interactive HTML map (dark mode):
   • 🟢 Top ranked → 🟡 Mid → 🔴 Lowest — color-coded pins
   • Clickable popups: rank, score, reviews, address
   • Sidebar leaderboard with score bars

💡 Use a single focused search term (e.g. "italian restaurant") so all places are in the same category and can be meaningfully compared.

---

💡 Tips for Best Results

More results

• Use locationQuery — the scraper automatically splits large areas into a grid of searches, unlocking thousands of results past Google's 120-result cap.
• Multiple distinct search terms (["restaurant", "bar", "cafe"]) run separately and combine results.

Cleaner results

• Avoid near-duplicates like ["restaurant", "restaurants"] — same results, slower run.
• Use categoryFilterWords to narrow broad searches.

Reviews efficiently

• Set maxReviews only as high as needed.
• Combine reviewsSort: "newest" + reviewsStartDate to collect only recent feedback.

Proxy

• For < 100 places, default proxies are fine.
• For large-scale runs or reviews, use Apify residential proxies for maximum reliability.

---

📊 Export Formats

Format	Best for
JSON	Full nested structure, API ingestion
CSV / Excel	Spreadsheet analysis, CRM import
XML	Legacy system integrations

For review analysis: use the Reviews dataset view to get one row per review instead of one row per place.

---

❓ FAQ

How is this different from the Google Places API? The Google Places API caps results at 60 per search and requires billing. This scraper has no result cap, no API key, and extracts more fields (popular times, full reviews, images, contact enrichment).

Can I scrape multiple cities in one run? Yes — use customGeolocation with a MultiPolygon containing one polygon per city.

Can I scrape a specific list of businesses? Yes — provide Google Maps URLs in startUrls or Place IDs in placeIds.

Can I schedule recurring runs? Yes — use Apify's built-in scheduling to run daily, weekly, or on any cron schedule.

Is it legal? Scraping publicly visible business data is generally permitted. Handle reviewer personal data in accordance with GDPR/CCPA. Disable reviewer data collection with scrapeReviewsPersonalData: false.

---

🔗 Integrations & API

Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("YOUR_ACTOR_ID").call(run_input={
    "searchStringsArray": ["coffee shop"],
    "locationQuery": "Berlin, Germany",
    "maxCrawledPlacesPerSearch": 100,
    "maxReviews": 5,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items

Node.js:

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('YOUR_ACTOR_ID').call({
    searchStringsArray: ['coffee shop'],
    locationQuery: 'Berlin, Germany',
    maxCrawledPlacesPerSearch: 100,
    maxReviews: 5,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Also integrates with: Zapier, Make, Google Sheets, Slack, Airbyte, LangChain, and any tool supporting webhooks.

---

📬 Feedback & Issues

Found a bug or want a new feature? Open an issue on the actor's Issues tab. All feedback is actively monitored.