Google Maps scraper API

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

Web & maps 5 capabilities stable 96.9% success rate

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Enrich Business


            enrich.google-maps

1 credit / request Endpoint docs Copy coding prompt

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.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"business_name":"Apple Inc","city":"Cupertino","state":"CA"},"capability":"enrich.google-maps"}'

Input

Field	Type	Required	Description
`business_name`	string	required	Business name to search for.
`city`	string	optional	City name for location bias.
`country`	string	optional	Country code (default 'us').
`lang`	string	optional	Language code (default 'en').
`state`	string	optional	State or region for location bias.

Search Nearby


            googlemaps.nearby

1 credit / request Endpoint docs Copy coding prompt

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.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"lat":37.7749,"limit":20,"lng":-122.4194,"query":"coffee","radius":500},"capability":"googlemaps.nearby"}'

Input

Field	Type	Required	Description
`country`	string	optional	Country code (default 'us').
`lang`	string	optional	Language code (default 'en').
`lat`	number	required	Latitude (required).
`limit`	integer	optional	Max results (default 60, max 120).
`lng`	number	required	Longitude (required).
`query`	string	optional	Keyword filter, e.g. 'coffee'.
`radius`	integer	optional	Search radius in meters (default 1000).
`types`	array<string>	optional	Place types, e.g. ['restaurant'].

Get Place


            googlemaps.place

1 credit / request Endpoint docs Copy coding prompt

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.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"Empire State Building New York"},"capability":"googlemaps.place"}'

Input

Field	Type	Required	Description
`country`	string	optional	Country code (default 'us').
`lang`	string	optional	Language code (default 'en').
`query`	string	optional	Place name or address, e.g. 'Shake Shack Madison Square Park'.
`url`	string	optional	Full Google Maps URL (name extracted from path).

List Reviews


            googlemaps.reviews

1 credit / request Endpoint docs Copy coding prompt

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.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"feature_id":"0x89c259a57ed8c6a3:0x7fde98e2e28a5bca","limit":50,"sort":"newest"},"capability":"googlemaps.reviews"}'

Input

Field	Type	Required	Description
`feature_id`	string	optional	0x...:0x... from SearchPlaces/GetPlace result (preferred).
`lang`	string	optional	Language code (default 'en').
`limit`	integer	optional	Max reviews to return (default 100).
`sort`	string	optional	Sort order.
`url`	string	optional	Google Maps URL (name extracted for feature_id lookup).

Search Places


            googlemaps.search

1 credit / request Endpoint docs Copy coding prompt

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.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":20,"location":"San Francisco, CA","query":"coffee shops"},"capability":"googlemaps.search"}'

Input

Field	Type	Required	Description
`country`	string	optional	Country code for gl param (default 'us').
`lang`	string	optional	Language code (default 'en').
`lat`	number	optional	Latitude for geo-bias (use with lng).
`limit`	integer	optional	Max records to return (default 60, max 120).
`lng`	number	optional	Longitude for geo-bias.
`location`	string	optional	Location bias appended to query, e.g. 'New York, NY'.
`query`	string	required	Search query, e.g. 'pizza restaurants'.
`zoom`	integer	optional	Map zoom level (default 14; higher = tighter area, lower = wider).

Run Google Maps in under a minute

Get an API key