Use this endpoint to resolve a textual query (for example a business name or street address) into matching Tripadvisor Locations. Results are restricted to Locations you are licensed to access and return the full Location representation. ## 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 Locations matching the query, each annotated with the value that matched - PageSearchLocation - `data` SearchLocation[], required - `location` Location — A Tripadvisor Location: a point of interest such as a hotel or other accommodation, a restaurant, or an attraction.
This is the full representation returned by the Location endpoints, combining factual data (names, address, coordinates, contact details, categories, opening hours) with rich content (descriptions, traveler ratings, rankings, awards, and aggregate photo information). Optional fields are omitted from the response when no data is available for the Location.
- `accommodation` Accommodation
- `brand` string — Hotel brand name (e.g. "Marriott", "Hilton").
- `chain` string — Hotel chain affiliation (e.g. "Marriott International").
- `prices` Price[] — Rate ranges for the accommodation, one entry per currency.
- `currency` string — ISO 4217 currency code for the rates (e.g. "USD", "EUR").
- `max_rate` number — Maximum room rate in the specified currency.
- `min_rate` number — Minimum room rate in the specified currency.
- `room_count` integer — Total number of rooms at the accommodation.
- `star_rating` integer — Official star rating of the accommodation (1–5).
- `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
- `attributes` Attribute[] — Descriptive attributes of the Location, such as amenities and features (e.g. Free Wi-Fi, Outdoor Pool).
- `id` string — Unique identifier for the attribute
- `name` string — Human-readable name of the attribute
- `type` string — Type of attribute (e.g., "amenity", "feature", "service")
- `type_id` string — Type identifier for the attribute
- `awards` AwardV1[] — Tripadvisor awards the Location has received (e.g. Travelers' Choice).
- `category` string — Category of the award (e.g., "restaurants", "hotels")
- `geo` string — Geographic location where the award was received
- `image` ImageUrl
- `key` string — Unique identifier for the image
- `url` string — URL to access the image
- `name` string — Name of the award
- `type` 'Certificate of Excellence' | 'Travelers' Choice'
- `year` integer — Year the award was received
- `categories` Category[] — The categories this Location is classified under, including the top-level category and parent hierarchy (e.g. Lodging > Hotels).
- `display_name` string — Human-readable display name for the category
- `hierarchy` string — Hierarchical path of the category (e.g., "restaurants > fine_dining")
- `id` string, required — Unique identifier for the category
- `parent_category` ParentCategory
- `display_name` string — Display name for the parent category
- `id` string — Unique identifier for the parent category
- `parent_category` object
- `top_level_category` 'Accommodation' | 'Experience' | 'Attraction' | 'Eat & Drink'
- `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
- `neighborhoods` Neighborhood[] — Neighborhoods (sub-geographic areas) that the Location is part of.
- `geo_id` string
- `name` string
- `official_email` string — The Location's official contact email address, when available.
- `opening_hours` OpeningHours
- `formatted` string[] — Human-readable formatted opening hours strings
- `periods` Period[] — List of opening hours periods for different days of the week
- `closes` string — Closing time in HH:MM format (24-hour)
- `day_of_week` 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Sunday'
- `opens` string — Opening time in HH:MM format (24-hour)
- `timezone` string — Timezone identifier for the opening hours (e.g., "America/New_York")
- `phone_numbers` PhoneNumber[] — Contact phone numbers for the Location, each tagged with its type (e.g. phone, fax).
- `type` string, required — Type of phone number (e.g., "main", "fax", "mobile", "toll-free")
One of: