Google Maps Place List Scraper

Search Google Maps with ordinary query and location fields and receive a ranked, deduplicated list of public places. The Actor captures validated structured Maps responses when available and merges them with visible result cards as a DOM fallback.

Input

{
  "query": "coffee shops",
  "location": "Times Square, New York",
  "maxItems": 20,
  "maxItemsPerQuery": 20,
  "maxScrollRounds": 8,
  "language": "en",
  "country": "US",
  "useApifyProxy": false
}

Use queries for a batch. maxItems is global and maxItemsPerQuery bounds each search. Legacy startUrls, searchTerms, maxPlaces, maxPages, countryCode, and proxy-editor input remain accepted. Direct, authorized Apify Proxy, and custom proxy URL modes are supported; proxy credentials are never logged or stored.

The complete input contract, including defaults and compatibility aliases, is in .actor/input_schema.json.

Output

Each dataset row represents a real Google Maps place and includes stable identity, Maps URL, name, ranked position, query context, source, extraction method, and scrape timestamp. Public category, address, coordinates, rating, review count, price, status, sponsored placement, place attributes, image, website, phone, time zone, and country fields are included only when the source exposes them. Card-level fields such as attributes and sponsored status are captured from visible result cards; richer place fields are retained from validated Maps results when available.

Live page observation

Chrome was used to inspect the public results for coffee shops Times Square, New York. The visible 787 coffee card showed its name, 4.9 rating, 3,582 reviews, $1 to $10 price range, Coffee shop category, wheelchair-accessible entrance, address, and opening status. Its Maps link exposed a place ID, CID, and coordinates. The excerpt below records only those page-visible values; it is an observation, not an Actor run or a complete dataset row:

{
  "name": "787 coffee",
  "placeId": "ChIJfbedxbZZwokRpbnR5BBdz1c",
  "cid": "0x89c259b6c59db77d:0x57cf5d10e4d1b9a5",
  "latitude": 40.7597441,
  "longitude": -73.9875048,
  "category": "Coffee shop",
  "rating": 4.9,
  "reviewCount": 3582,
  "priceLevel": "$1 to $10",
  "address": "245 W 46th St",
  "status": "Open · Closes 9 PM",
  "openNow": true,
  "isSponsored": false,
  "attributes": ["Wheelchair accessible entrance"]
}

The dataset schema is strict and contains no raw response bodies, cookies, authorization material, proxy URLs, signed URLs, or synthetic placeholder records. Duplicate places are removed using place ID, CID, or a stable name/address identity.

All output fields, types, and requiredness are defined in .actor/dataset_schema.json.

No-results searches finish successfully with an empty dataset and OUTPUT.status = "no-results". Invalid input fails before crawling. Explicit CAPTCHA or traffic-block pages fail closed and are never stored.

Responsible use

This Actor accesses public Google Maps data only. It does not bypass authentication, CAPTCHA, paywalls, account restrictions, or other access controls. Use modest limits, comply with applicable terms and laws, and only process data for an appropriate lawful purpose.