# Google Maps API

Google Maps — business search, place details, nearby search, reviews, and business enrichment.

- Platform ID: `googlemaps`
- Capabilities: 5
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/googlemaps/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [Enrich Business](https://docs.upscrape.com/docs/platforms/googlemaps/enrich.google-maps) | `enrich.google-maps` | 1 credit per request | Unified enrichment lookup: find a business on Google Maps by name + optional city/state and return the best-match Place with phone, website, address, rating, hours, coordinates. |
| [Search Nearby](https://docs.upscrape.com/docs/platforms/googlemaps/googlemaps.nearby) | `googlemaps.nearby` | 1 credit per request | Search for places near a coordinate — returns name, address, phone, website, rating, coordinates, and categories for businesses within a given radius. Supports keyword filtering and place type constraints. |
| [Get Place](https://docs.upscrape.com/docs/platforms/googlemaps/googlemaps.place) | `googlemaps.place` | 1 credit per request | Fetch full details for a single place — name, address, phone, website, rating, review count, coordinates, categories, opening hours, photos, and Google Maps URL. Provide a search query or a Maps URL. |
| [List Reviews](https://docs.upscrape.com/docs/platforms/googlemaps/googlemaps.reviews) | `googlemaps.reviews` | 1 credit per request | Stream all reviews for a place. Provide one of: feature_id (preferred), place_id, cid, or url. If feature_id is not provided, an extra request is made to resolve it. |
| [Search Places](https://docs.upscrape.com/docs/platforms/googlemaps/googlemaps.search) | `googlemaps.search` | 1 credit per request | Search Google Maps for businesses by keyword and optional location — returns name, address, phone, website, rating, coordinates, categories, and place IDs. Supports geo-bias via lat/lng/zoom and country filtering. |


## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).