Guest Ratings and Reviews
File Content and Purpose
This file contains a collection of guest ratings and guest reviews for all properties where data is available. The file should be used by partners who would like to include guest-generated content on their websites or applications.
File Format
Inside the .zip file you will find 6 compressed .jsonl files which contain ~1.5 million property listings.
Each .jsonl file will contain a collection of separate, valid JSON objects, one per line.
The break between files will always fall between JSON objects, so you can assume all JSON files are complete.
The grouping of the properties into the files is random, so you will need to parse all 6 files to find all properties of a given type or in a given location, etc.
File Update Schedule
This file is currently scheduled to be updated every Tuesday, with a new version published at 3pm Pacific time each week.
File Download Link
Downloading the full content file will require an Expedia API key with permissions added for static data download.
Sample File Download
You can download a sample file that will give you an idea of the content and structure of the full Vacation Rental File download:
- Download SAMPLE Vacation Rental Data File
Complete File Download
To download the complete Vacation Rental Data File, please follow the instructions on the page linked below:
Sample Guest Ratings and Reviews Record
This is an example of a lodging property that has reviews available from multiple brands.
{
"propertyId": {
"expedia": "19744033",
"hcom": "632809056",
"vrbo": ""
},
"propertyType": {
"id": 1,
"name": "Hotel"
},
"country": "Thailand",
"guestRating": {
"expedia": {
"avgRating": "9.0",
"reviewCount": "4"
},
"hcom": {
"avgRating": "9.5",
"reviewCount": "0"
},
"vrbo": {
"avgRating": "9.0",
"reviewCount": "3"
}
},
"guestReviews": [
{
"reviewerScore": "8",
"reviewBrand": "hcom",
"creationDate": "2017-11-15 13:03:00",
"checkinDate": "Nov 1, 2017 5:00:00 PM",
"checkoutDate": "Nov 3, 2017 5:00:00 PM",
"languageCode": "en",
"reviewText": "The Nang Rong Hotel about 5 min from the main road is a great little Oasis of peace in an otherwise hectic and chaotic city. Rooms are clean, the bed is very comfy and the shower has hot water. If you are a light sleeper try to opt for a room out back. The two boys at the reception do not speak much english but will go out of their way to accommodate any wishes. The lake area is only a short 10 min walk away where you can find food stalls and bbq restaurants. The HOtel can also organize a taxi service to Phanom Rung ruins and other temples in the vicinity that are worth visiting for a very reasonable price.Definitely highly recommended."
}
]
}Items to Note
- Average Rating Score - The
guestRatingsection represents the average score using the same scale as used by the corresponding website (10 point scale for Expedia, Hcom and Vrbo).
This has been done so that the partner can select whichever point scale and value best matches the site to which they are directing users to book.
Review Scores - The scores for each review are listed on a 10-point scale for Expedia, Hcom and Vrbo. This has been done to ensure that the scale of individual review scores aligns with the scale of average rating scores.
Number of Reviews - All available reviews over 2-year period have been included.
Consistency of Localized Reviews - For localized reviews we include all reviews from the designated Point of Sale. This does not guarantee that all content is in the requested language, as some guests may leave a review in an alternate language.