// request reference
Tripadvisor Search parameters
Send query parameters with GET /api/tripadvisor/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.
Place search
Search Tripadvisor’s first-party persisted-query API.
qRequired search text.
Example / input hint: coffee
tripadvisor_domainSupported first-party localized Tripadvisor hostname.
Example / input hint: www.tripadvisor.com
localeLanguage or language-COUNTRY code.
Example / input hint: en-US
geo_idOptional Tripadvisor geography identifier.
Example / input hint: 30196
latOptional search center; requires longitude.
Example / input hint: 30.27
lonOptional search center; requires latitude.
Example / input hint: -97.74
place_typeRestrict the result entity type.
allaccommodationattractionattraction_producteaterygeostartOffset from 0 through 10,000.
Example / input hint: 0
num1 through 30 results.
Example / input hint: 5
// response
Work with the complete JSON response
Response groups include search_results, map_previews, search_information, pagination. Groups and fields depend on the upstream result.
The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.