Location Details requests

A Location Details request takes a Tripadvisor Location ID and returns the full record for that Location. A Location is an accommodation, a restaurant or an attraction. Destinations such as cities and regions are Geos, and are returned by Geo Details.

A request is an HTTP GET to a URL in the form:

https://terra.tripadvisor.com/api/locations/{id}

Location Details responses

The response is a single Location object, returned directly rather than wrapped in an envelope. The batch endpoint, Multiple Locations Details, wraps its results in a data array.

Fields with no data are omitted rather than returned as null or {}. Code against absence.

id, geo, geo_id, names, descriptions, photos and status are always present.

Identifiers

The Location's identifier is id. geo_id identifies the containing destination and can be passed to Geo Details.

Ratings

traveler_ratings carries overall alongside three sibling arrays: subratings, breakdowns and language_counts.

traveler_ratings.overall.icon_url and subratings[].icon_url are URL strings on this endpoint. The equivalent fields on Location Reviews are objects. The field names match; the types do not.

Conditional fields

Some fields appear only for a particular kind of Location:

• price_level — restaurants only. One of Cheap Eats, Mid Range, Fine Dining.
• accommodation — accommodations only. Carries brand, chain, room count, star rating and rate ranges.
• recommended_visit_length — attractions only. A code, not a duration: 0 unknown, 1 under 1 hour, 2 1–2 hours, 3 2–3 hours, 4 over 3 hours.

status.value is one of OPEN, CLOSED or TEMPORARILY_CLOSED.

photos.total_count is a count. The photos themselves come from Location Photos.

Locales

locale is repeatable and is applied in priority order. Translated fields — names, descriptions, addresses — return one entry per resolved locale. Enum labels such as category display names and award names resolve using the first locale only.

Note: results are restricted to your allowlist. A Location you are not licensed to access returns 404, not a partial record.

Examples

Retrieve a Location

curl "https://terra.tripadvisor.com/api/locations/187147?version=1" \
  -H "X-API-Key: API_KEY"

Retrieve a Location in two locales

curl "https://terra.tripadvisor.com/api/locations/187147?version=1&locale=es-MX&locale=fr-FR" \
  -H "X-API-Key: API_KEY"

Related

• Multiple Locations Details — several Locations in one call
• Location Reviews and Location Photos
• Geo Details — resolve geo_id to a destination
• Supported Locales — locale codes and the fallback chain
• Brand Guidelines and Linking Policy — display requirements