List a Google Maps place's reviews

POST/v1/tools/google.maps.reviews/callsNeeds an API key

Returns a Google Maps place's reviews, with rating, text, author, date and the owner's response. Use it to track what customers say about a place.

Tool google.maps.reviews on Google. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

place_idstringRequired

Google's place ID of the place, such as "ChIJaXQRs6lZwokRY6EFpJnhNNE".

sortstring

Order of the reviews. Google's own order is relevance.

relevance

newest

highest_rating

lowest_rating

countrystring

Two-letter ISO 3166-1 country code. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same place, sort, country and language.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`reviews`

A list of rows. Always present, possibly empty.

review_idstring

Google's identifier of the review.

ratingnumberRequired

Stars the reviewer gave, from 1 to 5.

textstring

What the reviewer wrote. Absent when only a rating was left.

urlstring

Address of the review on Google Maps.

author_namestring

author_urlstring

Address of the reviewer's Google Maps profile.

author_image_urlstring

Address of the reviewer's profile picture.

published_atstring

When the review was written, in ISO 8601.

published_labelstring

Age of the review as Google shows it, such as "5 months ago". Not a timestamp.

likesinteger

Number of people who marked the review helpful.

image_urlsarray of string

Address of each photo attached to the review.

owner_response_textstring

The owner's reply to the review.

owner_response_published_atstring

When the owner replied, in ISO 8601.

owner_response_published_labelstring

Age of the reply as Google shows it. Not a timestamp.

`place`

One object. Can be null.

titlestring

Name of the business or place.

addressstring

ratingnumber

Average review rating, out of 5.

review_countinteger

categorystring

Kind of business, such as "Coffee shop".

`pagination`

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.

curl https://api.voxoria.ai/v1/tools/google.maps.reviews/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"place_id":"ChIJaXQRs6lZwokRY6EFpJnhNNE","sort":"newest"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.maps.reviews/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {
            "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
            "sort": "newest",
        },
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google.maps.reviews/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {
      "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
      "sort": "newest",
    },
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.maps.reviews",
    "input": {
      "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
      "sort": "newest"
    }
  }
}

200 OKoutputapplication/json

{
  "reviews": [
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25GSU1IRjBlbkJQV21KQ2JIbFpXSGh4WW0xVGIzYxAB",
      "rating": 5,
      "text": "The Empire State Building is the most famous building in New York! A beautiful historic Art Deco skyscraper, and the view of Manhattan from the top is amazing. You can see the whole city, the rivers and the bridges. An iconic place you have to visit at least once. I recommend it!",
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25GSU1IRjBlbkJQV21KQ2JIbFpXSGh4WW0xVGIzYxAB!2m1!1s0x0:0xd134e199a405a163!3m1!1s2@1:CAIQACodChtycF9oOnFIMHF0enBPWmJCbHlZWHhxYm1Tb3c%7C%7C?hl=en",
      "author_name": "Rodrigo Cunha",
      "author_url": "https://www.google.com/maps/contrib/100857332173426743898?hl=en",
      "author_image_url": "https://lh3.googleusercontent.com/a-/ALV-UjXI8-08dMbdklIcyu461xJ-rRnzihKjJDbsWR-XMAhPdgfgXihIPw=s120-c-rp-mo-ba12-br100",
      "published_at": "2026-10-28T04:37:32Z",
      "published_label": "3 hours ago",
      "likes": 0,
      "image_urls": null,
      "owner_response_text": null,
      "owner_response_published_at": null,
      "owner_response_published_label": null
    },
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xGUk1WZ3RUVEZXY3pOWVJEQllSV0ZaZHpaVGJuYxAB",
      "rating": 5,
      "text": "The observation platform is brilliant for the best views of the whole of New York.",
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xGUk1WZ3RUVEZXY3pOWVJEQllSV0ZaZHpaVGJuYxAB!2m1!1s0x0:0xd134e199a405a163!3m1!1s2@1:CAIQACodChtycF9oOlFRMVgtTTFWczNYRDBYRWFZdzZTbnc%7C%7C?hl=en",
      "author_name": "Mark Oliver",
      "author_url": "https://www.google.com/maps/contrib/100022844969326458165?hl=en",
      "author_image_url": "https://lh3.googleusercontent.com/a/ACg8ocLj_Y2k7BDqZkpaMQ40sSzQ8i6hLrTY2_6hmrmuJWLCBXdDWQ=s120-c-rp-mo-ba12-br100",
      "published_at": "2026-10-28T03:33:28Z",
      "published_label": "4 hours ago",
      "likes": 0,
      "image_urls": null,
      "owner_response_text": null,
      "owner_response_published_at": null,
      "owner_response_published_label": null
    },
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21relZWZE1WRTlUYjJsQmJtZFVTVWRmUlVwNlVHYxAB",
      "rating": 5,
      "text": null,
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21relZWZE1WRTlUYjJsQmJtZFVTVWRmUlVwNlVHYxAB!2m1!1s0x0:0xd134e199a405a163!3m1!1s2@1:CAIQACodChtycF9oOmkzVVdMVE9Tb2lBbmdUSUdfRUp6UGc%7C%7C?hl=en",
      "author_name": "Peethani Srinivas",
      "author_url": "https://www.google.com/maps/contrib/100268064251489450810?hl=en",
      "author_image_url": "https://lh3.googleusercontent.com/a-/ALV-UjU7nVfLTObMxQAg3jJ9fY-ldKTCO8tGH5bjfAEe5Ze29cP5rk8B=s120-c-rp-mo-ba12-br100",
      "published_at": "2026-10-28T01:27:52Z",
      "published_label": "6 hours ago",
      "likes": 0,
      "image_urls": null,
      "owner_response_text": null,
      "owner_response_published_at": null,
      "owner_response_published_label": null
    }
  ],
  "place": {
    "title": "Empire State Building",
    "address": "20 W 34th St., New York, NY 10001",
    "rating": 4.7,
    "review_count": 131015,
    "category": "Observation deck"
  },
  "pagination": {
    "next_page_token": "pt1.bGl0ZXNjcmFwZTpsczEuV3lKRGFUaEpRVkpKYmtObmIwRlFOekpHTmtKSlJIaGFYMTlGYUVSaFFsUkZXWGRMVUdRdFkyWmZabEZOUVVGQlFVRkhaMlpmUVd3MlFrbEVlRnBIUVVGcFFVRTZNakFpTENKek1HMDJRbEZqU1Y5RlJUTnRPRWRFV0hkRE5YRWlYUQ"
  }
}

The output of a real call, each list cut to 3 items.