# List a Tripadvisor business's reviews

Returns a Tripadvisor place's reviews, with rating, title, text and date. Use it to track what guests say about a business.

Tool `tripadvisor.business.reviews` on Tripadvisor. Contract version 1, released 2026-10-27.

## Example call

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

cURL:

```bash
curl https://api.voxoria.ai/v1/tools/tripadvisor.business.reviews/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"location_id":"18941405","sort":"newest"}}'
```

Python:

```python
import os

import httpx

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

TypeScript:

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

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "tripadvisor.business.reviews",
    "input": {
      "location_id": "18941405",
      "sort": "newest"
    }
  }
}
```

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `location_id` | string | Yes |  | Tripadvisor's location ID of the place, such as "18941405". The location_id of a tripadvisor.search.general result. Matches `^[0-9]{1,16}$`. |
| `sort` | string | No |  | Order of the reviews. One of `relevance`, `newest`. |
| `page` | integer | No | `1` | Page of reviews, 10 to a page. A page past the last has no reviews. From 1 to 1001. |

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `review_id` | string | No | Tripadvisor's identifier of the review. |
| `rating` | number | Yes | Stars the reviewer gave, from 1 to 5. |
| `title` | string | No | Headline of the review. |
| `text` | string | No | What the reviewer wrote. |
| `url` | string | No | Address of the review on Tripadvisor. |
| `published_at` | string | No | When the review was published, in ISO 8601. A date only where that is all Tripadvisor gives. |
| `likes` | integer | No | Number of people who marked the review helpful. |

## Example output

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

```json
{
  "reviews": [
    {
      "review_id": "1081306431",
      "rating": 5,
      "title": "Fantastic Experience",
      "text": "Amazing! On the top of the one stars we’ve been. Great Sake pairing and the food was to close your eyes and delight on",
      "url": "https://www.tripadvisor.com/ShowUserReviews-g30196-d18941405-r1081306431-Austin_Proper_Hotel-Austin_Texas.html",
      "published_at": "2026-10-11",
      "likes": 0
    },
    {
      "review_id": "1081283848",
      "rating": 5,
      "title": "Excellent hotel with minor gripes",
      "text": "Stayed here for 3 nights in October 2026 on business. I reserved a standard 1 King room and am a Marriott Bonvoy Platinum member.\n\nOverall, this was an excellent hotel and stay. I would stay here again without hesitation. The Austin Proper is a smaller luxury boutique hotel with a cool, upscale vibe that sets it apart from the larger chain hotels.\n\nPositives\n\n•\tGreat location. The hotel is in a nice part of Austin, approximately a 15-minute drive from AUS. It is just a few blocks from the Lady Bird Lake trail, which was excellent for morning walks and runs. The surrounding neighborhood also has plenty of restaurants, bars, and shopping within easy walking distance.\n•\tEasy check-in. I was able to complete online check-in the day before arrival, and the hotel stayed in contact with me via text. One issue, however, was that I could not see my reservation in the Bonvoy app, even though the property is part of the Marriott Bonvoy family.\n•\tNice room upgrade. I was upgraded from a standard 1 King to a Deluxe room. The main difference was the additional square footage. The room also had a nice view of the pool deck and was adequately furnished with a dresser and wardrobe.\n•\tExcellent bathroom amenities. The bathroom was stocked with Aesop bath products, which smelled great - not too strong and neither particularly masculine nor feminine. There were also several thoughtful toiletry items, including cotton balls, makeup-remover towels, Q-tips, and nail files.\n•\tBest part of the room: the shower. The water pressure was AMAZING. Not only was the water temperature consistently warm, but the pressure was easily the best I've ever experienced at a hotel. Hotel showers often have little to no pressure; this one was the exact opposite. Honestly, the shower alone elevates this room to 10 stars.\n•\tVery good food and service. Breakfast in the lobby restaurant was pricey but very good, with excellent service in a comfortable setting and just the right amount of atmosphere. The same goes for evening cocktails in the lobby lounge.\n•\tGood fitness center and pool area. The fitness center was small but had a good selection of equipment. Everything appeared to be higher-end equipment, and there were enough machines and weights to get in a good workout. The hotel also has a nice pool deck with a relatively small pool that was adequate for doing some short laps. The pool was chilly in the morning.\n\nNegatives\n\n•\tPrice. The hotel was expensive. Even with a corporate/group rate, my room was just under $600 per night. Austin was particularly busy during my stay due to ACL, but even taking that into account, the rate was still a little on the high side. A fairly traditional breakfast—eggs, meat, toast, and tea—was around $50, which was also expensive.\n•\tBonvoy app integration. As mentioned above, there was no convenient way for me to access my reservation information through the Bonvoy app. Since the hotel is part of the Bonvoy family, I would expect the reservation to appear there.\n•\tBathroom mirror setup. The bathroom had a large, oval decorative mirror with sconces for lighting, but the mirror was not centered over the sink. Unless you're over 6 feet tall, you can’t see much of your reflection. The largest part of the mirror was essentially positioned over the toilet. Not ideal.\n•\tBathroom light dimmer didn't work. On my first night, the overhead bathroom light remained on because I couldn't get the dimmer switch to operate. I contacted the front desk the next morning, and it eventually got fixed, although it required several visits from the engineering team.\n•\tHonor bar/fridge issue. The honor-bar refrigerator had a half-empty bottle of champagne/prosecco left over from the previous guest. That's a little sloppy on the part of housekeeping. Also, there is no empty refrigerator space for guests to store personal items such as a water bottle.\n•\tNo Bonvoy elite food-and-beverage credit. There was no daily food-and-beverage credit for Bonvoy elite members.\n\nOverall, this was an excellent hotel and a great 3-night stay, even with the relatively minor issues mentioned above. The Austin Proper has a great location, a distinctive boutique atmosphere, excellent service, and some very nice amenities. The shower alone deserves special mention!\nI would definitely stay here again. If the hotel could improve its integration with the Bonvoy app and address some of the smaller room and housekeeping issues, it would move even further up my list of top hotels I’ve visited in recent memory.",
      "url": "https://www.tripadvisor.com/ShowUserReviews-g30196-d18941405-r1081283848-Austin_Proper_Hotel-Austin_Texas.html",
      "published_at": "2026-10-10",
      "likes": 0
    },
    {
      "review_id": "1080151477",
      "rating": 5,
      "title": "Best time!",
      "text": "The Proper is such a beautiful hotel and Kendra at the valet was so helpful!",
      "url": "https://www.tripadvisor.com/ShowUserReviews-g30196-d18941405-r1080151477-Austin_Proper_Hotel-Austin_Texas.html",
      "published_at": "2026-10-02",
      "likes": 0
    }
  ]
}
```