PropertyList Mega Feed

This feed provides property details around hotels, restaurants, and attractions. Including address, description, ratings, review count, amenities, booking url, Closed status, and other details. Property feeds will include all locations that haven't been closed for more than 19 days.

The data model for the feed can be seen in the resources below. Note the displayed data model is generic and might have differences to the ones served to Partners. Partners should make sure to their existing contracts to identify which datasets are available in their own feeds.


XML Schema: https://tripadvisor-hs-standard-content-feed.s3.amazonaws.com/schemas/tripadvisor_propertylist.xsd

JSON Schema: https://tripadvisor-hs-standard-content-feed.s3.amazonaws.com/schemas/tripadvisor_propertylist.json

 

Field Name

Description

id

Unique Tripadvisor location ID of the destination or POI.

geoid
The TripAdvisor id for the geo the location is included in.

PartnerId
The partner ID for the property, if there is a partner mapping associated with this feed.

Name: []

- lang

- value

Localized location name

- language of the name

- value of the name
TripAdvisorURL URL on the TA site
ViewPhotosURL URL for the view photos link
BookingURL URL for the booking link
WriteReviewURL URL for the write a review link
AllQuestionsAndAnswersURL URL for the page with all questions and answers

Category: []

- lang

- value

- type
Each POI on Tripadvisor is classified under a "category" and "subcategory", which is included in the API response. Categories and subcategories may also be used to filter the /location method when a destination (geo) location ID is used.
- language of the category
- value of the category
- type of the category
Description Localized location description
lang The language of the description
value The value of the description
Address
The street address of the location. Not applicable for location type: geographic.
GeoHierarchy
NUM:NUM:Name|NUM:NUM:Name|... for the hierarchy of locations with this as the leaf

PhoneNumber:

- type

- number

Phone number list

- type of the number

- phone number
RoomCount Number of rooms, if it's a hotel
PropertyURL Official URL for the location
Latitude
If available and configured, this will hold location's latitude.
Longitude
If available and configured, this will hold location's longitude.

GeoCode: []

- GeoCodeSource

- Latitude

- Longtitude
A list of geo code objects. The source is one of the following: * owned by the partner, so the partner's name * owned or licensed for distribution by TripAdvisor, so "tripadvisor" * some other source that has a specific agreement with the partner already
 
- Source for a GeoCode, in most cases "tripadvisor"
- If available and configured, this will hold geocode's latitude.
- If available and configured, this will hold geocode's longitude.
AverageRating Average rating on TripAdvisor
RawRating The raw rating used on TripAdvisor to determine ranking
RatingImageURL The rating image usable in search results
ReviewCount Number of reviews on TripAdvisor

RankingData

- RankingGeo

- RankingGeoId

- RankingPosition

- RankingDenominator

- Ranking
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.

Popularity

- PopularityIndex

- PopularityOutOf

- PopularitySubtypeCategory

- PopularitySubtype

- PopularitySubtypeOutOf

 Popularity element to hold popularity information
PhotoCount Number of photos on TripAdvisor

UserReviewRating: []

- name

- score

- total

 Property rating

RatingBreakdown: []

- name

- numReviews

- score

 Rating breakdown by number of reviews and rating
Brand Brand information, if available, hotels only
Chain Chain information, if available, hotels only
PriceLevel
The relative price level for the POI. Not available for all POIs. This string is localized into select other currency symbols (e.g. ££££ or €€€€) if a language other than English (en_US) is requested or if a specific currency is selected.

Price

- minRate

- mxRate

- currency

 Price information

Amenities: []

- name

Amenities offered by hotel

- Amenity name offered by hotel

Awards: []

- type

- year

- geo

- winninggeo

- category

 Awards for this location

- award type. always currently set to TravelersChoice

Ancestors: []

- id

- level

- name
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.

Hours

- day

- timezone

- OpenHours
Provides localized opening hours for Restaurants and Attractions, using ISO 8601 format.
- Open hours information, if available, for restaurants only
GoodFor: []
Good for romantic, doing business, local cuisine, etc, for restaurants only
AlsoKnownAs: [] List of AKA, or aliases
Closed
Whether the property is closed, presence means this property is closed

SubCategories: []

- name
Listings that are accommodations/hotels or restaurants are assigned a single subcategory. Deprecated as of February 2017 for Attractions. Refer to the "groups" object for the most up to date classifications.
Email The contact email of the POI
Menu  menu information for restaurants

Neighborhoods: []

- locationId

- name

  neighborhoods information of the location

NearestMetroStations: []

- distance

- name

  nearest metro station data

LocationString: []

- lang

- value

 The location string for this property

AttractionTypes

- attractionType: []

- name

 The attractions type classification, only for attractions

RecommendedVisitLength

- lang

- value

  

Cuisine

- item: []

- name

cuisine information for the restaurants 

 

SubRatings

- rating: []

- value

- name

- imageUrl

 The subratings for this property

SpecialDiet

- diet: []

- name

 Special diets provided by this restaurant

Features

- feature: []

- name

 The features of this property

Meals: 

- meal: []

- name

 Meals provided by this restaurant

TravelSafeData

- safety: []

- name
The travel safe data provided by the management of this property

TripTypeBreakdown: []

- name

- numReviews

 TripType breakdown by number of reviews and rating

LanguageReviewCount: []

- lang

- count

 The amount of reviews in each language

AlsoViewed: []

- id

 Top also viewed properties

QuestionsAndAnswers: []

- lang

- datePublished

- question

- author

- answers

- allAnswersToQuestionURL

 Questions and Answers for this property
TourOperator  

Type:
- lang

- TypeName

- SubType

- SubTypeName

- SubTypeCategories

Similar to Category, describes type and subtype information about the property.

Example: Type is "Restaurant", SubType is "Bars & Pubs", SubTypeCategories are "Contemporary" and "Wine Bar".

 

ListingStatus:

- Status

- ClosedDate

- ReopenDate

Describes current status for the property (if it's open, temporarily closed, or closed). Also provides closure details if available.

 

Example in XML format:

<Property id="1520958" geoid="255098">
 <Name lang="en">Moosehead Lodge</Name>
 <TripadvisorURL>
 http://www.tripadvisor.com/Hotel_Review-g255098-d1520958-Reviews-m99999-Moosehead_Lodge-Victoria.html</TripadvisorURL>
 <WriteReviewURL>
 http://www.tripadvisor.com/UserReview-g255098-d1520958-m99999-Moosehead_Lodge-Victoria.html</WriteReviewURL>
 <ViewPhotosURL>
 http://www.tripadvisor.com/LocationPhotos-g255098-d1520958-m99999-Moosehead_Lodge-Victoria.html</ViewPhotosURL>
 <Type lang="en">
 <TypeName>Hotel</TypeName>
 <SubType>17</SubType>
 <SubTypeName>Lodge</SubTypeName>
 </Type>
 <Description lang="en">Moosehead, Reindeer &amp; Jenny's Cottages are located a scenic 2.5 hour drive east of
 Melbourne adjacent to Mt Baw Baw National Park.These self contained cottages are decorated in a rustic country
 charm reminiscent of a bygone era.Surrounded by tall mountain ash gums and giant tree ferns.Hand feed the rosellas,
 king parrots and kookaburras.</Description>
 <Address lang="en">
 <StreetAddress>Tramline Road Tanjil Bren</StreetAddress>
 <DisplayAddress>Tramline Road Tanjil Bren, Victoria 3833 Australia</DisplayAddress>
 <PostalCode>3833</PostalCode>
 <State>Victoria</State>
 <Country>AU</Country>
 </Address>
 <RoomCount>3</RoomCount>
 <AverageRating>5.0</AverageRating>
 <ReviewCount>29</ReviewCount>
 <Popularity>
 <PopularityIndex>157</PopularityIndex>
 <PopularityOutOf>7120</PopularityOutOf>
 </Popularity>
 <PhotoCount>25</PhotoCount>
 <Price minrate="145" maxrate="318" currency="USD" />
 <Closed/>
 </Property>

 Example in JSON format:

 {
    "Name" : [ {
      "lang" : "en",
      "value" : "Moosehead Lodge"
    } ],
    "TripAdvisorURL" : "https://www.tripadvisor.com/Hotel_Review-g255098-d1520958-Reviews-Moosehead_Lodge-Victoria.html?m=67805",
    "ViewPhotosURL" : "https://www.tripadvisor.com/Hotel_Review-g255098-d1520958-Reviews-Moosehead_Lodge-Victoria.html?m=67805#photos",
    "WriteReviewURL" : "https://www.tripadvisor.com/UserReview-g255098-d1520958-Moosehead_Lodge-Victoria.html?m=67805",
    "Type" : {
      "TypeName" : "Hotel",
      "SubType" : 17,
      "SubTypeName" : "Lodge",
      "lang" : "en"
    },
    "Description" : [ {
      "lang" : "en",
      "value" : "Moosehead, Reindeer & Jenny's Cottages are located a scenic 2.5 hour drive east of Melbourne adjacent to Mt Baw Baw National Park.These self contained cottages are decorated in a rustic country charm reminiscent of a bygone era.Surrounded by tall mountain ash gums and giant tree ferns.Hand feed the rosellas, king parrots and kookaburras."
    } ],
    "Address" : [ {
      "lang" : "en",
      "StreetAddress" : "Tramline Road",
      "StreetAddress2" : "Tanjil Bren",
      "DisplayAddress" : "Tramline Road Tanjil Bren, Victoria 3833 Australia",
      "PostalCode" : "3833",
      "State" : "Victoria",
      "Country" : "AU",
      "CountryName" : "Australia"
    } ],
    "RoomCount" : 3,
    "AverageRating" : 5.0,
    "ReviewCount" : 54,
    "Popularity" : {
      "PopularityIndex" : 286,
      "PopularityOutOf" : 2336,
      "PopularitySubtypeCategory" : "Specialty Lodging",
      "PopularitySubtype" : 286,
      "PopularitySubtypeOutOf" : 2336
    },
    "Price" : {
      "minrate" : 145,
      "maxrate" : 318,
      "currency" : "USD"
    },
    "Closed" : false,
    "id" : 1520958,
    "geoid" : 255098
}