🛰 Google Maps Scraper

Detect emerging restaurants, cafés, hotels, salons, gyms and local businesses on Google Maps with smart review velocity tracking. l Live hotel rates from Booking, Agoda & Expedia and many more. This Actor is a persistent monitoring engine designed for competitive intelligence, lead generation, and market research. It focuses on new and growing businesses rather than one-time bulk scraping.

🎯 Key Features

• Smart Incremental Mode — Only processes places with new reviews after initial crawl
• Persistent KV Store — Remembers every business across runs (Single Source of Truth)
• Business Age & Freshness Detection — Uses actual review timestamps
• Hotel Intelligence — Real-time rate tracking (Booking, Expedia, Agoda, etc.)
• Dynamic Scoring — Velocity, momentum spikes, emerging flags
• Monthly Full Refresh — Forces re-enrichment every 30 days
• Clean Dual Output — User-friendly dataset + Intelligence dataset

📊 Output

• Main Dataset ({category}-{location})
• Business details, contact info, short Maps URL
• Up to 100 recent reviews
• Intelligence fields (score, velocity, emerging, isSpike)
• Intelligence Dataset ({category}-{location}-intel)
• Scoring metrics, freshness category, rate statistics (for hotels)

📊 Output Examples

Business Dataset

{
  "name": "Sea Flower Cafe and Espresso Bar",
  "placeId": "ChIJP3mABP0nhIAR-ypVLCjrifw",
  "rating": 4.8,
  "reviewCount": 133,
  "address": "2001 CA-1, Bodega Bay, CA 94923, USA",
  "phone": "(707) 377-4253",
  "website": "http://seaflowercafe.com/",
  "mapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJP3mABP0nhIAR-ypVLCjrifw",
  "reviews": [ ... ], 
  "score": 0.82,
  "velocity": 4.2,
  "emerging": true,
  "isSpike": false,
  "businessFreshness": "fresh"
}

** Hotel / Accommodation Dataset (extra fields) **

{
  "name": "Oceanview Boutique Hotel",
  "category": "hotel",
  "rating": 4.7,
  "reviewCount": 245,
  "minRate": 180,
  "maxRate": 220,
  "averageRate": 195,
  "score": 0.85,
  "velocity": 3.5,
  "emerging": true,
  "isSpike": true,
  "isAccommodation": true
}

---

** Intelligence Dataset ** (light version for analysis) Contains score, velocity, emerging, businessAgeCategory, businessFreshness, rate stats, etc.

⚙ Input Configuration

** Basic Example – New Cafés in San Francisco **

{
  "searchQuery": "cafes",
  "location": "San Francisco, CA",
  "maxResults": 200,
  "minRating": 3.5,
  "newReviewThreshold": 30,
  "safeMode": false
}

** Multi-category + Hotels **

{
  "searchQuery": ["hostels", "hotels", "resorts"],
  "location": "Austin, TX",
  "maxResults": 300,
  "minRating": 4.0,
  "newReviewThreshold": 20
}

** Safe Mode (for testing) **

{
  "safeMode": true,
  "searchQuery": "cafes",
  "location": "New York, NY"
}

---

🧠 Intelligence Layer (Dynamic Scoring)

*For every listing we calculate:

• Velocity — new reviews per day

• Dynamic Score (0–1):

• Growth velocity: 40%

• Rating: 30%

• Recency (≤30 days full value): 20%

• Low review volume bonus: 10%

• Momentum spike bonus: +0.2

• Emerging flag — true if velocity ≥ 5 or score ≥ 0.75

• Business Freshness — fresh / recent / stale based on oldest review age

• Finds newly opened & fast-growing businesses on Google Maps. Tracks review velocity, captures real customer reviews, enriches via Places API, and extracts live hotel rates from Booking, Agoda & Expedia and many more.

---

💼 Ideal Use Cases

POS & suppliers — reach new restaurants/hotels early Marketing & delivery apps — target fresh locations Hotel & accommodation scouts — monitor new openings and rate trends Franchise & real estate — track expansion Competitive intelligence — weekly emerging competitor reports Lead generation — feed enriched data directly into CRM/outreach

---

📁 Output Structure

Default Dataset → Immediate view in Output tab (clean business data) Named Dataset → {category}-{location} (persistent history) Intelligence Dataset → {category}-{location}-intel (scoring + freshness) KV Store → google-maps-{category}-{location} (Single Source of Truth + snapshots)

---

💰 Pricing (Pay per Event)

Actor start: $0.00005 Per enriched result: $0.15 (only when address/phone/website successfully retrieved)

Typical monthly monitoring run (500–1000 new/enriched listings) ≈ $75–$150.

---

⚠️ Best Practices

The Actor has capability to use RESIDENTIAL proxies (Highly Recommended to use) Schedule daily or weekly runs for best velocity tracking Start with safeMode: true when testing new locations Respect Google’s Terms of Service

---

Future Enhancements (Roadmap)

• Business closure detection
• Rating/review change alerts
• Webhook notifications
• Advanced filters (price level, opening hours, amenities)

---

Ready to spot new opportunities first?

• Run the Actor now or schedule it for continuous intelligence.
• Questions? Open an issue or message the developer.
• Happy monitoring! 🚀