Location Details

get https://api.content.tripadvisor.com/api/v1/location/{locationId}/details

A Location Details request returns comprehensive information about a location (hotel, restaurant, or an attraction) such as name, address, rating, and URLs for the listing on Tripadvisor.

Response

Response body

object

location_id

int32

Unique Tripadvisor location ID of the destination or POI

name

string

Name of the POI as listed on Tripadvisor

description

string

Description of the POI as listed on Tripadvisor

web_url

string

Link to the POI detail page on Tripadvisor. Link is localized to the correct domain if a language other than English is requested.

address_obj

object

Object containing address data for this location

street1

string

The street name

street2

string

The street name continuation

city

string

The city name

state

string

The state

country

string

The country

postalcode

string

The address postal code

address_string

string

The address in one single sentence

ancestors

array of objects

Ancestors describe where the POI or destination lives within the Tripadvisor destination or geo hierarchy.
From this, you can derive the city where a POI is located, as well as state/province/region and country.

ancestors

object

abbrv

string

The ancestor location abbreviation

level

string

The ancestor location level in relation to the location

name

string

The ancestor location name

location_id

int32

The ancestor location location identifier

latitude

number

The latitude of this location in degrees, if available

longitude

number

The longitude of this location in degrees, if available

timezone

string

The timezone of the location

string

The email of the location, if available

phone

string

The phone number of the location, if available

website

string

The website of the location, if available

write_review

string

Link to the review form for this specific POI on Tripadvisor. Link is localized to the correct domain if a language other than English is requested.

ranking_data

object

Describes a POI's Popularity Index ranking on Tripadvisor, which compares places of interest (accomodations, restaurants, and attractions) within the same destination based on their popularity.
This is measured by the quality, quantity, and recency of their review content on Tripadvisor.

geo_location_id

int32

The destination id

ranking_string

string

The description of the ranking

geo_location_name

string

The destination name

ranking_out_of

int32

The total number of locations on the ranking score

ranking

int32

The location ranking

rating

number

Overall rating for this POI. Not applicable to geographic locations. Rating levels are defined as follows:
5: Excellent
4: Very good
3: Average
2: Poor
1: Terrible

rating_image_url

string

URL to the bubble rating image for this location. Overall Bubble Ratings must be displayed using the Tripadvisor bubble rating image with the owl icon.

num_reviews

string

Count of total reviews published for this location

review_rating_count

object

Count of reviews for this location at each traveler rating level (1,2,3,4,5)

Has additional fields

subratings

object

photo_count

int32

The count of photos for this POI published on Tripadvisor

see_all_photos

string

Link to open all photos posted for this POI in a photo viewer on Tripadvisor. Link is localized to the correct domain if a language other than English is requested.

price_level

string

The relative price level for the POI. Not available for all POIs. This string is localized to other currency symbols (e.g. ££££ or €€€€) if a language other than English (en_US) is requested or if a specific currency is selected.

hours

object

Provides localized opening hours for Restaurants and Attractions, using ISO 8601 format

periods

array of objects

periods

object

open

object

The day and times intervals in which the location is open

object

The day and times intervals in which the location is closed

weekday_text

array of strings

weekday_text

amenities

array of strings

The amenities provided by this hotel

amenities

features

array of strings

The features provided by this restaurant

features

cuisine

array of objects

The cuisines of this restaurant

cuisine

object

name

string

localized_name

string

parent_brand

string

The parent brand of this hotel

brand

string

The brand of this hotel

categories

array of objects

Attraction Categories

categories

object

name

string

localized_name

string

styles

array of strings

The styles of the hotel

styles

neighborhood_info

array of objects

List of neighborhoods close to the location

neighborhood_info

object

location_id

string

name

string

trip_types

array of objects

Each review submitted on Tripadvisor is tagged with a trip type, as designated by the reviewer.
For each POI location, a breakdown of the total review count by trip type is included in the "trip_types" object.

trip_types

object

name

string

localized_name

string

value

string

awards

array of objects

Returns a list of all of the awards for this location, which could include Certificate of Excellence, Travelers' Choice, and Green Leader.
For each award, a small and large image will be returned as well.

awards

object

award_type

string

Award type name

year

int32

The year in which the award was awarded

images

object

The award image in its different sizes

categories

array of strings

The categories in which the award was awarded

categories

display_name

string

error

object

message

string

type

string

code

int32

Language

Credentials

Query


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.content.tripadvisor.com/api/v1/location/locationId/details?language=en&currency=USD' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Details for the location