Google Maps

Google Maps place data for agents: search places, find nearby locations, fetch place details, reviews, photos, and individual review content, plus language and place-type reference lists.

GET/v1/google-maps/search

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

10 tokens

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_maps

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

Response18 fields

placesarrayitems

15 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.

typesarrayitems

1 field

Place type labels when available.

typestring

Place type label.

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"
}

GET/v1/google-maps/nearby-search

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

10 tokens

Search Google Maps for places near a latitude and longitude.

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_maps_nearby

Parameters11 fields

locationstringRequired

Latitude and longitude of the search point (for example 40,-110).

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

sort_by"Relevance" | "Distance"Optional

Result ordering: "Relevance" (default) or "Distance".

max length 32

keywordstringOptional

Keyword to match nearby places (for example restaurant).

max length 256

Response18 fields

placesarrayitems

15 fields

Nearby places matching the search criteria. 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.

typesarrayitems

1 field

Place type labels when available.

typestring

Place type label.

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/nearby-search"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "location": "-33.8688,151.2093",
    "keyword": "restaurant",
    "radius": 1000
}

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

Example responses1 example

200Sample nearby search response (truncated).

restaurants_near_sydney.json

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

GET/v1/google-maps/places/details

https://api.vee3.io/v1/google-maps/places/details

4 tokens

Fetch detailed Google Maps place information by place identifier.

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

get_google_maps_place_details

Parameters3 fields

place_idstringRequired

Google Maps place identifier (for example ChIJk_grnPDq9EcRE7gOH9gAPZA). Also accepts the business identifier form (for example 0x47f4eb87e91f866d:0x9629fabb993eb66).

max length 256

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

languagestringOptional

Language code for results (for example en).

max length 16

Response16 fields

namestring

Place display name.

full_addressstring

Full formatted address when available.

ratingnumber

Average user rating when available.

review_countinteger

Total number of reviews 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.

websitestring

Place website when available.

phone_numberstring

Place phone number when available.

typesarrayitems

1 field

Place type labels when available.

typestring

Place type label.

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/places/details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "place_id": "0x47f4eb87e91f866d:0x9629fabb993eb66"
}

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

Example responses1 example

200Sample place details response (truncated).

carmelo_details.json

{
  "name": "Carmelo",
  "full_address": "Carmelo, 7 Rue Neuve, 69001 Lyon",
  "rating": 4.7,
  "review_count": 10762
}

GET/v1/google-maps/places/reviews

https://api.vee3.io/v1/google-maps/places/reviews

3 tokens

Fetch Google Maps reviews for a place by place identifier.

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

get_google_maps_place_reviews

Parameters5 fields

place_idstringRequired

Google Maps place identifier (for example ChIJk_grnPDq9EcRE7gOH9gAPZA). Also accepts the business identifier form (for example 0x47f4eb87e91f866d:0x9629fabb993eb66).

max length 256

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

languagestringOptional

Language code for results (for example en).

max length 16

cursorstringOptional

Pagination cursor from cursor_next on a previous response.

max length 4096

sort_by"Relevant" | "Lowest" | "Highest" | "Newest"Optional

Review sort order: "Relevant" (default), "Lowest", "Highest", or "Newest".

max length 32

Response19 fields

placeobject

12 fields

Place metadata for the reviewed location.

namestring

Place display name.

full_addressstring

Full formatted address when available.

ratingnumber

Average user rating when available.

review_countinteger

Total number of reviews 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.

reviewsarrayitems

4 fields

Place reviews.

review_idstring

Review identifier.

review_textstring

Review body text.

ratinginteger

Star rating for the review.

user_namestring

Reviewer display name when available.

cursor_nextstring

Cursor for the next page when more results are 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/places/reviews"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "place_id": "0x47f4eb87e91f866d:0x9629fabb993eb66",
    "sort_by": "Relevant"
}

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

Example responses1 example

200Sample place reviews response (truncated).

carmelo_reviews.json

{
  "place": {
    "name": "Carmelo",
    "full_address": "Carmelo, 7 Rue Neuve, 69001 Lyon",
    "rating": 4.7,
    "review_count": 10762
  },
  "reviews": [
    {
      "review_id": "ChdDSUhNMG9nS0VJexample",
      "review_text": "Great food and atmosphere.",
      "rating": 5
    }
  ],
  "cursor_next": "sample_review_cursor"
}

GET/v1/google-maps/places/photos

https://api.vee3.io/v1/google-maps/places/photos

3 tokens

Fetch Google Maps photos for a place by place identifier.

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

get_google_maps_place_photos

Parameters4 fields

place_idstringRequired

Google Maps place identifier (for example ChIJk_grnPDq9EcRE7gOH9gAPZA). Also accepts the business identifier form (for example 0x47f4eb87e91f866d:0x9629fabb993eb66).

max length 256

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

languagestringOptional

Language code for results (for example en).

max length 16

cursorstringOptional

Pagination cursor from cursor_next on a previous response.

max length 4096

Response17 fields

placeobject

12 fields

Place metadata for the photo listing.

namestring

Place display name.

full_addressstring

Full formatted address when available.

ratingnumber

Average user rating when available.

review_countinteger

Total number of reviews 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.

photosarrayitems

2 fields

Place photos.

photo_urlstring

Photo URL.

descriptionstring

Photo description when available.

cursor_nextstring

Cursor for the next page when more results are 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/places/photos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "place_id": "0x47f4eb87e91f866d:0x9629fabb993eb66"
}

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

Example responses1 example

200Sample place photos response (truncated).

carmelo_photos.json

{
  "place": {
    "name": "Paris",
    "full_address": "Paris, France"
  },
  "photos": [
    {
      "photo_url": "https://example.com/photo.jpg"
    }
  ],
  "cursor_next": "sample_photo_cursor"
}

GET/v1/google-maps/reviews/details

https://api.vee3.io/v1/google-maps/reviews/details

2 tokens

Fetch a single Google Maps review by review identifier.

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

get_google_maps_review_details

Parameters1 field

review_idstringRequired

Google Maps review identifier.

max length 512

Response4 fields

review_idstring

Review identifier.

review_textstring

Review body text.

ratinginteger

Star rating for the review.

user_namestring

Reviewer display name 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/reviews/details"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "review_id": "ChdDSUhNMG9nS0VJLVlfZFhBMzl2enVBRRAB"
}

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

Example responses1 example

200Sample review details response (truncated).

sample_review.json

{
  "review_id": "ChdDSUhNMG9nS0VJLVlfZFhBMzl2enVBRRAB",
  "review_text": "Excellent experience.",
  "rating": 5
}

GET/v1/google-maps/place-types

https://api.vee3.io/v1/google-maps/place-types

1 tokens

List supported Google Maps place type values for search filters.

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

get_google_maps_place_types

Parameters0 fields

Response2 fields

place_typesarrayitems

1 field

Supported Google Maps place type string values.

place_typestring

Place type value (for example restaurant).

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/place-types"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {

}

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

Example responses1 example

200Sample place types (truncated).

sample_place_types.json

{
  "place_types": [
    "restaurant",
    "cafe",
    "bar",
    "museum",
    "park"
  ]
}

GET/v1/google-maps/languages

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

1 tokens

List supported language codes for Google Maps place endpoints.

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

get_google_maps_languages

Parameters0 fields

Response2 fields

languagesobject

1 field

Map of language names to language codes for Google Maps place endpoints (for example English: en).

<language>string

Language code for the named language (for example en).

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/languages"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {

}

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

Example responses1 example

200Sample language map (truncated).

sample_languages.json

{
  "languages": {
    "English": "en",
    "French": "fr",
    "German": "de"
  }
}