Skip to main content
GET
Tripadvisor Hotels
Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string

Query Parameters

q
string
required
depth
integer
sort_by
enum<string>
Available options:
BEST_VALUE,
RANKED,
PRICE_LOW_TO_HIGH,
DISTANCE
price_min
integer
price_max
integer
star_rating_min
enum<string>
Available options:
any,
0,
1,
2,
3,
4,
5
review_score_min
enum<string>
Available options:
any,
3,
3.5,
4,
4.5,
5
property_type
enum<string>
Available options:
any,
hotel,
resort,
apartment,
villa,
hostel,
guest_house,
bed_and_breakfast
currency
string

Response

Successful response. data is specific to this operation.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.