# Search Tripadvisor places, hotels, restaurants and forums

Returns the Tripadvisor places, hotels, restaurants and forums that match a search. Use it to find a place's location ID.

Tool `tripadvisor.search.general` 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.search.general/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"hotels in austin texas","place_type":"hotel"}}'
```

Python:

```python
import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/tripadvisor.search.general/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {"query": "hotels in austin texas", "place_type": "hotel"},
    },
    timeout=60,
)
print(response.json())
```

TypeScript:

```ts
const response = await fetch("https://api.voxoria.ai/v1/tools/tripadvisor.search.general/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {"query": "hotels in austin texas", "place_type": "hotel"},
  }),
});
console.log(await response.json());
```

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "tripadvisor.search.general",
    "input": {
      "query": "hotels in austin texas",
      "place_type": "hotel"
    }
  }
}
```

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 |
| --- | --- | --- | --- | --- |
| `query` | string | Yes |  | What to look for on Tripadvisor, such as "hotels in Austin, Texas". 1 to 500 characters. |
| `place_type` | string | No |  | Keeps only the places of this kind. All kinds when left out. One of `hotel`, `restaurant`, `attraction`, `activity`, `geo`. |
| `page` | integer | No | `1` | Page of results, 10 to a page. From 1 to 1001. |

## Output

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

### results

A list of rows. Always present, possibly empty.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `position` | integer | Yes | Rank among the places found, starting at 1. |
| `title` | string | Yes | Name of the place. |
| `location_id` | string | No | Tripadvisor's location ID of the place, in decimal digits. |
| `url` | string | No | Address of the place's page on Tripadvisor. |
| `place_type` | string | No | Kind of place: a hotel or other lodging, a restaurant, an attraction, a bookable activity such as a tour, or a geography such as a city. One of `hotel`, `restaurant`, `attraction`, `activity`, `geo`. |
| `category` | string | No | Kind of place as Tripadvisor names it, such as "Hotel". |
| `location` | string | No | Place the result is in, such as "Austin, Texas". |
| `description` | string | No |  |
| `rating` | number | No | Average review rating, out of 5. |
| `review_count` | integer | No |  |

## Example output

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

```json
{
  "results": [
    {
      "position": 1,
      "title": "Austin Proper Hotel",
      "location_id": "18941405",
      "url": "https://www.tripadvisor.com/Hotel_Review-g30196-d18941405-Reviews-Austin_Proper_Hotel-Austin_Texas.html",
      "place_type": "hotel",
      "category": "Hotel",
      "location": "Austin, Texas",
      "description": "Located in Downtown Austin's vibrant Second Street District, Austin Proper Hotel and Residences brings together Kelly Wearstler's layered interiors, elevated wellness, and the culinary vision of MML Hospitality. The property features 234 guest rooms and suites alongside 99 private residences, creating a stay that feels both deeply personal and connected to the city's creative energy. Dining spans four distinct destinations, from rooftop restaurant La Piscina, known for Mexican-inspired fare, small-batch tequilas, and sweeping Lady Bird Lake views, to Kappo Kappo, the hotel's intimate omakase experience rooted in traditional Japanese kappo dining. Guests can also enjoy a full-service spa, fitness center, and rooftop pool deck, all designed to move seamlessly with the rhythm of modern Austin living.",
      "rating": 4.6,
      "review_count": 1025
    },
    {
      "position": 2,
      "title": "Austin Southpark Hotel",
      "location_id": "111395",
      "url": "https://www.tripadvisor.com/Hotel_Review-g30196-d111395-Reviews-Austin_Southpark_Hotel-Austin_Texas.html",
      "place_type": "hotel",
      "category": "Hotel",
      "location": "Austin, Texas",
      "description": "Daily Mandatory Charge includes: Austin Tourism Public Improvement District Fee At the junction of Interstate 35 and State Highway 71, our hotel is a short drive to top destinations in Austin. Hike and bike trails at Barton Creek Greenbelt and Lady Bird Lake are within five miles. We're seven miles from the airport and University of Texas at Austin. Our hotel offers on-site dining, event space, and an indoor/outdoor pool.",
      "rating": 4.2,
      "review_count": 2252
    },
    {
      "position": 3,
      "title": "Archer Hotel Austin",
      "location_id": "9807437",
      "url": "https://www.tripadvisor.com/Hotel_Review-g30196-d9807437-Reviews-Archer_Hotel_Austin-Austin_Texas.html",
      "place_type": "hotel",
      "category": "Hotel",
      "location": "Austin, Texas",
      "description": "Located in northwest Austin in the heart of The Domain, an exclusive fashion and culinary destination with 220+ retailers and restaurants including Neiman Marcus, Nordstrom, RH Gallery from Restoration Hardware and the new energetic Rock Rose district with its mix of homegrown shops, dining and Viva Day Spa - all steps from Archer.",
      "rating": 4.7,
      "review_count": 1556
    }
  ]
}
```