Search Tripadvisor places, hotels, restaurants and forums

POST/v1/tools/tripadvisor.search.general/callsNeeds an API key

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.

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

querystringRequired

What to look for on Tripadvisor, such as "hotels in Austin, Texas".

1 to 500 characters.

place_typestring

Keeps only the places of this kind. All kinds when left out.

hotel

restaurant

attraction

activity

geo

pageinteger· default 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.

positionintegerRequired

Rank among the places found, starting at 1.

titlestringRequired

Name of the place.

location_idstring

Tripadvisor's location ID of the place, in decimal digits.

urlstring

Address of the place's page on Tripadvisor.

place_typestring

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.

hotel

restaurant

attraction

activity

geo

categorystring

Kind of place as Tripadvisor names it, such as "Hotel".

locationstring

Place the result is in, such as "Austin, Texas".

descriptionstring

ratingnumber

Average review rating, out of 5.

review_countinteger

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

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())

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());

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

200 OKoutputapplication/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
    }
  ]
}

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