Google Maps API reference
Search Google Maps the way a person does and get every place back as clean JSON: name, address, phone, website, hours, rating and coordinates. No Google Cloud project and no API key from Google.
The Google Maps API has 6 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Google Maps in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are query and url. Prices run from 2–10 credits to 5–200 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
googlemaps.search |
Search Google Maps by keyword and place, such as coffee shops in San Francisco. | 2–10 credits |
googlemaps.place |
Get one place from its name, address, place ID or a Google Maps link: address, phone, website, opening hours, rating, review count, categories and coordinates. | 2 credits |
googlemaps.nearby |
Find places around a point, nearest first, each with its distance in meters. | 2–10 credits |
googlemaps.enrich |
Match a business name, with an optional city and state, to its Google Maps listing and get its address, phone, website, hours, rating and a confidence for the match. | 2 credits |
googlemaps.reviews |
Read a place's public reviews with rating, date and text, newest, most relevant, highest or lowest first. | 5–200 credits |
googlemaps.suggest |
Get Google Maps' suggestions for the start of a search, with the place's ID and coordinates when the suggestion is a place. | 2 credits |
What to know
- What Google Maps shows Each place carries what its listing shows publicly. A place with no website or phone on Google Maps comes back without one.
- Nearby keeps to the radius Places outside the radius you set are left out, so a nearby list never drifts into the next area.
- Ratings at the moment of the call Ratings and review counts are Google Maps' own numbers when you call, so they move over time.
- Matches come with confidence Enrich returns its best match and how sure it is. Add a city and state for common names and check the low ones.
Something missing or unclear? Ask the team that builds the Google Maps endpoints.