Sign in

v1

latestOpenAPI 3.0.12026-07-24178873.1 KB
Location

Search Locations

Finds Locations 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. Results are restricted to Locations you are licensed to access and return the full Location representation.
get/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 Locations matching the query, each annotated with the value that matched

Example response

{
  "data": [
    {
      "location": {
        "opening_hours": {
          "periods": [
            {
              "closes": "20:00:00",
              "opens": "08:00:00"
            }
          ]
        }
      }
    }
  ]
}