Google Maps Scraper

Extract structured place data from Google Maps by searching a keyword around a center location and radius. The actor saves clean place records for lead generation, local SEO, market mapping, territory planning, and enrichment workflows.

What It Does

• Searches Google Maps from a keyword, center location, radius, language, and region.
• Saves deduplicated place records by place_id when available.
• Includes contact, location, rating, website, photos, hours, attributes, H3 cell, plus code, and Maps URL when Google exposes them.
• Produces an interactive results map in the default key-value store.

Input

{
  "queries": "Chinese Restaurant",
  "location": "Manhattan, New York",
  "radiusKm": 15,
  "maxResults": 900,
  "language": "en",
  "region": "US"
}

Fields

• queries - Search term or category.
• location - Center point for the search. Use a place name, city, region, landmark, or lat,lng.
• radiusKm - Search radius in kilometers from the center location.
• maxResults - Maximum number of places to save for the run.
• language - Preferred result language, such as en, fr, or es-MX.
• region - Preferred country/region code, such as US, GB, or CA.

The actor fails clearly if location cannot be resolved. Use a more specific place name or exact coordinates when a location is ambiguous.

Output

Each dataset item is a place record:

{
  "query": "Chinese Restaurant",
  "h3": "872a100b1ffffff",
  "rank": 3,
  "processed_rank": 3,
  "place_id": "ChIJrXva_oJYwokROtv_EdGJgH0",
  "name": "Example Restaurant",
  "formatted_address": "2450 Broadway, New York, NY 10024",
  "location": { "lat": 40.7911087, "lng": -73.9739812 },
  "rating": 4.4,
  "user_ratings_total": 6848,
  "types": ["Chinese restaurant", "Restaurant"],
  "phone": "(212) 555-0100",
  "website": "https://example.com/",
  "maps_url": "https://www.google.com/maps/place/?q=place_id%3AChIJrXva_oJYwokROtv_EdGJgH0",
  "price_range": "$$",
  "opening_hours": "Monday: 11 AM-10 PM\nTuesday: 11 AM-10 PM",
  "description": "Casual neighborhood restaurant.",
  "photos": ["https://lh3.googleusercontent.com/p/example=w800-h600-k-no"],
  "photo_count": 12,
  "plus_code": "Q2R4+CC New York",
  "time_zone": "America/New_York",
  "service_attributes": {
    "Service options": ["Dine-in", "Takeout"],
    "Payments": ["Credit cards"]
  },
  "source_url": "https://www.google.com/maps/search/...",
  "scraped_at": "2026-05-29T22:35:10.000Z"
}

Fields are populated only when available in the current Google Maps response. Internal parser payloads and retry artifacts are not written to the public dataset.

Tips

• Use specific queries such as orthodontist, EV charger, or marketing agency.
• Use place_id as the stable key when joining or deduplicating exports.
• Group by h3 for geographic coverage analysis.
• Use the results map output for quick visual QA after a run.

Pricing

If this actor is published with pay-per-result pricing in Apify Console, charges should be based only on successfully saved dataset rows. This repository does not define an in-code Actor.charge event, so keep Console pricing and README copy in sync before publication.

Responsible Use

This actor extracts publicly available business information. Make sure your use complies with applicable laws, platform terms, and privacy requirements such as GDPR or CCPA.