Search Google Maps

Google Maps place search API and MCP. Find businesses, landmarks, and addresses from a text query such as restaurants in Paris. Each match includes the name, address, rating, and a place_id.

Open a match with Place details, read what people wrote on Place reviews, or get pictures from Place photos.

GET/v1/google-maps/search

https://api.vee3.io/v1/google-maps/search

10 tokens

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

google-maps.search

Parameters10 fields

querystringRequired

Search query for places (for example restaurants in Paris).

max length 512

locationstringOptional

Optional latitude and longitude bias point (for example 40,-110). A location embedded in the query may override this.

max length 64

radiusintegerOptional

Search radius in meters (default 1000).

min 1, max 50000

open_nowbooleanOptional

When true, return only places open for business at query time.

min_priceintegerOptional

Minimum price level (0–4, inclusive).

min 0, max 4

max_priceintegerOptional

Maximum price level (0–4, inclusive).

min 0, max 4

cursorstringOptional

Pagination cursor from cursor_next on a previous response.

max length 4096

languagestringOptional

Language code for results (for example en).

max length 16

regionstringOptional

Two-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_typestringOptional

Restrict results to a single Google Maps place type (for example restaurant).

max length 64

Response17 fields

placesarrayitems

14 fields

Matching places from the text search. Additional upstream fields may appear.

namestring

Place display name.

full_addressstring

Full formatted address when available.

place_idstring

Google Maps place identifier.

ratingnumber

Average user rating when available.

locationobject

2 fields

Place coordinates when available.

latitudenumber

Place latitude.

longitudenumber

Place longitude.

hoursobject

3 fields

Opening hours when available.

open_nowboolean

Whether the place is open now when only open_now is available.

<day>arrayitems

1 field

Opening hours ranges for a day of the week.

hours_rangestring

Opening hours range entry.

statusstring

Human-readable open/closed status when available.

typesstring[]

Place type labels when available.

business_statusstring

Operational status when available.

cursor_nextstring

Cursor for the next page when more results are available.

cursor_previousstring

Cursor for the previous page when available.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_maps_not_configured, google_maps_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/google-maps/search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "restaurants in Paris"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample text search response (truncated).

restaurants_in_paris.json

{
  "places": [
    {
      "name": "Grana",
      "full_address": "Ground Floor/5-7 Young St, Sydney NSW 2000, Australia",
      "place_id": "ChIJexample",
      "rating": 4.5,
      "location": {
        "latitude": -33.8625166,
        "longitude": 151.2109494
      }
    }
  ],
  "cursor_next": "sample_cursor_token"
}