Tripadvisor hub

Tripadvisor Search API

Cities, hotels, restaurants and attractions matching a name, with their location ids.

GET /v1/tripadvisor/search

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

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.