v1

latestOpenAPI 3.0.12026-07-24178873.1 KB
Catalog

Search Locations Catalog

Searches the Location catalog by free-text name or address.

<p>Use this endpoint to resolve a textual query (for example a business name or street address) into matching Tripadvisor Locations. This endpoint is not limited by a partner's allowlist or geofencing, but each result returns only the lightweight catalog projection of a Location.
get/catalog/locations/search

Query parameters

querystring required

Text search query.

search_typestring

Searching type.

country_codestring
Example:UA

Alpha-2 country code.

geo_namestring
Example:Ukraine

City, Town, or Country Geo Name.

postal_codestring

Postal/zip code to further narrow results.

<p> If both `geo_name` and `postal_code` are given, the `postal_code` takes precedence in case they do not resolve.
category'RESTAURANT' | 'ATTRACTION' | 'HOTEL'

Filter based on Tripadvisor’s top-level categories (eat & drink, accommodations, attractions).

localestring[]

preferred locales for localized fields (e.g. names, descriptions), in priority order; falls back to the default locale when omitted

pageinteger

Page index (1-based).

sizeinteger

Page size.

Response

a page of catalog Locations matching the query, each annotated with the value that matched