Tripadvisor Search API
Cities, hotels, restaurants and attractions matching a name, with their location ids.
GET /v1/tripadvisor/search1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/tripadvisor/search looks a name up the way the site's search box does. query is a place, hotel, restaurant or attraction name, up to 100 characters (eiffel tower, savoy london); type keeps one kind of match: geo for cities and regions, hotel, restaurant or attraction.
data.results lists the matches, best first. Each carries locationId, type, name with its location (Eiffel Tower, Paris, Ile-de-France, France), url, the geoId of the city it is in and coordinates. Pass a hotel, restaurant or attraction's locationId to its own route, and a geo match's locationId as geoId to the hotels, restaurants or attractions lists.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Tripadvisor Search API FAQ
How do I find a city's geo id?
Search with type=geo, for example query=paris&type=geo. The locationId of a geo match is the geoId the hotels, restaurants and attractions lists take. Paris is 187147, London 186338 and New York City 60763.
What if nothing matches?
The response is HTTP 200 with an empty results list. Try a shorter name, or drop type to see every kind of match.
Can I page through more matches?
No. Search answers the site's best matches for the name in one page. Use the hotels, restaurants or attractions lists to walk a city's places.
How many credits does a call cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Tripadvisor endpoints
- Place by URLGET /v1/tripadvisor/place
- Hotels in a cityGET /v1/tripadvisor/hotels
- Restaurants in a cityGET /v1/tripadvisor/restaurants
- Attractions in a cityGET /v1/tripadvisor/attractions
- Attraction types in a cityGET /v1/tripadvisor/attractions/types
- Cruise searchGET /v1/tripadvisor/cruises
- Cruise shipGET /v1/tripadvisor/cruise-ships/{locationId}
- Cruise ship reviewsGET /v1/tripadvisor/cruise-ships/{locationId}/reviews