# Google Maps Scraper API

> Search Google Maps by text or coordinates, look up one place, or read its reviews — JSON endpoints behind one API key, no browser and no CAPTCHA-solving.

This cluster covers the Google Maps workflow end to end. Business Search takes a free-text query, optionally centred on a latitude and longitude, and returns each matching place with its name, address, coordinates, category, rating, review count, opening hours, website and phone, plus the place id and feature id you can pass straight into Place Details. Place Details resolves one place by that id — or by a CID, a feature id, or a pasted Google Maps link — into the same full record. Reviews reads the review feed for a place: rating, full text, author, photos, timestamp and the owner’s reply, sorted by relevance, date or rating, with cursor pagination through the whole set. Every one of them is a pure HTTP call over upAPI’s own request path — no browser is launched, so there is nothing to solve a CAPTCHA on and no per-request compute cost to pass through. Each response is cached for a while after the first call, so a repeat lookup inside that window is free and instant; the exact time-to-live is on this page’s FAQ, generated from the same catalog the calls run against. Every field on this page is read directly from the operations’ own published output schema, so if Google adds or renames a field here, the page picks it up on the next deploy rather than drifting from what the API actually returns.

## Operations

- [Google Maps Business Search](https://upapi.io/apis/maps/google-maps-search) (6 units): Search Google Maps for businesses by text query, optionally centred on coordinates. Returns each place with its name, address, coordinates, category, rating, review count, opening hours, website and phone where Google publishes them, plus the place id you can pass to Google Maps Place Details.
- [Google Maps Place Details](https://upapi.io/apis/maps/google-maps-place) (4 units): Look up one Google Maps place by place id, CID, feature id or a pasted Maps link, and get its name, full address, coordinates, categories, rating, review count, phone, website and opening hours. Pairs with Google Maps Business Search, which returns the identifiers this accepts.
- [Google Maps Reviews](https://upapi.io/apis/maps/google-maps-reviews) (6 units): Read the reviews on any Google Maps place by place id, CID, feature id or a pasted Maps link. Returns each review's rating, full text, author, photos, timestamp and the owner's reply, sorted by relevance, date or rating, with cursor pagination through the whole feed.

## Frequently asked questions

### Do I need my own Google Maps API key or Google Cloud billing account?

No. These are upAPI operations, not a proxy in front of Google’s paid Places API — you call them with one upAPI key (the X-Api-Key header) and they run over upAPI’s own request path. There is nothing to enable in Google Cloud and no separate Google billing.

### How much does this cost?

Google Maps Business Search is 6 units per call; Google Maps Place Details is 4 units per call; Google Maps Reviews is 6 units per call — every unit draws from one pooled monthly quota shared across the whole catalog. See upapi.io/pricing for what a unit costs on each plan.

### How fresh is the data — is it cached?

Google Maps Business Search is cached for 30 minutes; Google Maps Place Details is cached for 1 hour; Google Maps Reviews is cached for 15 minutes. A repeat call inside a cached window returns the cached response and is billed nothing.

### Can I search by coordinates instead of a text query?

Yes. Business Search accepts an optional latitude/longitude pair to centre the search, plus a zoom value that controls the effective radius, alongside the required text query.

### What do I pass from a search result into Place Details?

Every place returned by Business Search carries a placeId, a featureId and a cid — Place Details accepts any of those ids, or a pasted Google Maps link, so you never have to hold onto the search response just to look one place up again later.

Last updated 2026-10-20.