Search Google Maps
Search Google Maps for places by text query.
← All Google Maps endpoints · Capability overview
/v1/google-maps/searchhttps://api.vee3.io/v1/google-maps/search
Search Google Maps for places by text query.
Authorization
Send your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
MCP
The same capability is available as an MCP tool on Vee3 hosted MCP.
Tool name
search_google_mapsParameters10 fields
querystringRequiredSearch query for places (for example restaurants in Paris).
max length 512
locationstringOptionalOptional latitude and longitude bias point (for example 40,-110). A location embedded in the query may override this.
max length 64
radiusintegerOptionalSearch radius in meters (default 1000).
min 1, max 50000
open_nowbooleanOptionalWhen true, return only places open for business at query time.
min_priceintegerOptionalMinimum price level (0–4, inclusive).
min 0, max 4
max_priceintegerOptionalMaximum price level (0–4, inclusive).
min 0, max 4
cursorstringOptionalPagination cursor from cursor_next on a previous response.
max length 4096
languagestringOptionalLanguage code for results (for example en).
max length 16
regionstringOptionalTwo-character region code (for example us). On search endpoints this biases results by ccTLD. On place endpoints this selects regional place data.
max length 8
place_typestringOptionalRestrict results to a single Google Maps place type (for example restaurant).
max length 64
Response18 fields
placesarrayitems15 fieldsMatching places from the text search. Additional upstream fields may appear.
placesarrayitemsnamestringPlace display name.
full_addressstringFull formatted address when available.
place_idstringGoogle Maps place identifier.
ratingnumberAverage user rating when available.
locationobject2 fieldsPlace coordinates when available.
locationobjectlatitudenumberPlace latitude.
longitudenumberPlace longitude.
hoursobject3 fieldsOpening hours when available.
hoursobjectopen_nowbooleanWhether the place is open now when only open_now is available.
<day>arrayitems1 fieldOpening hours ranges for a day of the week.
<day>arrayitemshours_rangestringOpening hours range entry.
statusstringHuman-readable open/closed status when available.
typesarrayitems1 fieldPlace type labels when available.
typesarrayitemstypestringPlace type label.
business_statusstringOperational status when available.
cursor_nextstringCursor for the next page when more results are available.
cursor_previousstringCursor for the previous page when available.
HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_maps_not_configured, google_maps_upstream_error