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. ## Query parameters - `query` string, required - `search_type` string - `country_code` string - `geo_name` string - `postal_code` string - `category` 'RESTAURANT' | 'ATTRACTION' | 'HOTEL' - `locale` string[] - `page` integer - `size` integer ## Response `200` a page of catalog Locations matching the query, each annotated with the value that matched - PageSearchCatalogLocation - `data` SearchCatalogLocation[], required - `location` CatalogLocation — A lightweight representation of a Tripadvisor Location returned by the Catalog endpoints.
The Catalog endpoints expose only this reduced set of fields. Use the id to look up the full Location details via the Location endpoints when you are licensed for that Location.
- `addresses` Address[] — Postal addresses for the Location, including a pre-formatted single-line representation per language.
- `city` string — City or municipality name
- `country_code` string — ISO 3166-1 alpha-2 country code (e.g., "US", "CA", "GB")
- `country_name` string — Full country name
- `formatted` string — Complete formatted address string
- `language` string — Language code for the address text (e.g., "en", "es", "fr")
- `postal_code` string — Postal or ZIP code
- `state` string — State, province, or region name
- `street_address` string — Primary street address line containing building number and street name
- `street_address2` string — Secondary street address line for apartment, suite, or unit information
- `coordinates` Coordinates
- `latitude` number, required — Geographic latitude coordinate in decimal degrees (-90 to 90)
- `longitude` number, required — Geographic longitude coordinate in decimal degrees (-180 to 180)
- `descriptions` Translation[], required — Editorial descriptions of the Location, provided in one or more languages.
- `language` string, required — Language code for the translation (e.g., "en", "es", "fr")
- `value` string, required — Translated text content in the specified language
- `geo` string, required — Display name of the Geo that this Location belongs to (e.g. "Lisbon").
- `geo_id` integer, required — Identifier of the Tripadvisor Geo (e.g. city or region) that this Location belongs to.
- `id` integer, required — Tripadvisor's unique identifier for this Location.
- `names` TranslationWithPrimary[], required — The Location's name in one or more languages. One name per language is flagged as the primary name.
- `language` string, required — Language code for the translation (e.g., "en", "es", "fr")
- `primary` boolean — Indicates if this is the primary language version of the text
- `value` string, required — Translated text content in the specified language
- `overall_rating` Overall
- `count` integer — Total number of reviews contributing to this rating
- `icon_url` string — URL to the rating icon/image
- `rating` number — Overall rating score (typically 1.0 to 5.0)
- `urls` Urls
- `android_intent` string
- `menu` string
- `official` string
- `tripadvisor` Tripadvisor
- `main` string
- `photos` string
- `questions_answers` string
- `write_review` string
- `matched_value` Translation
- `language` string, required — Language code for the translation (e.g., "en", "es", "fr")
- `value` string, required — Translated text content in the specified language
- `pagination` PageMetadata, required
- `page` integer — Current page number (1-based).
- `size` integer — Number of items per page.
- `total_elements` integer — Total number of elements
- `total_pages` integer — Total number of pages.
## Other responses
- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error
---
[API](https://skmtc.dev/tripadvisor/apis/partner-api.md) · [All operations](https://skmtc.dev/tripadvisor/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tripadvisor/partner-api/revisions/b42bdf9fd6a5/schema)