SocialGrid — Google Maps Scraper (actor)

Unofficial community Actor. Not affiliated with, endorsed by, or sponsored by Google.

Thin Apify wrapper over @socialgrid/scraper-google-maps. HTTP-only (no browser): it reads Google's internal /search?tbm=map JSON endpoint through a US residential proxy (Google serves reCAPTCHA/consent to datacenter IPs).

Modes

mode	input	returns
search	query (+ location, limit, cursor)	Page<Business> — businesses matching the keyword
place	query = business name + location	one Business — the best match
reviews	—	error. Not served here (see below)

Each run pushes exactly one ActorResult = { success, platform: "google_maps", mode, data?, error? }.

Reviews are not scraped here

Google gates review content behind bot detection on every transport it exposes — the HTTP listugcposts RPC returns an empty array for anonymous automated requests, and a headless browser is served a review-less "limited view". This was confirmed live to survive fresh residential IPs, human-like navigation, and full fingerprint-stealth patches. mode=reviews therefore returns a clear error; reviews are sourced from a maintained third-party provider at the consumer layer (see collab-radar-mcp's ApifyMapsProvider).

Fields

Business: place_id, feature_id, name, address, lat, lng, website, phone, category, categories, rating, review_count (present when Google exposes it), hours (null on this surface), url. null means "Google doesn't expose this field here", never fabricated.

Deploy

$./deploy.sh          # pnpm run bundle && apify push

ToS note

Scraping Google Maps is contrary to Google's Terms of Service; the sanctioned route is the Places API (which caps reviews at 5/place). Use conservatively.