Property Listings

File Content and Purpose

This file contains data about the listing itself, what inventory source it comes from, which sites it is bookable on, and what chain and brand it belongs to.

Inside the .zip file you will find 6 compressed .jsonl files. 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 Listings File download:

Download SAMPLE Listings Data File

Complete File Download

To download the complete Listings Data File, please follow the instructions on the page linked below:

Download COMPLETE Listings Data File

Sample Property Listing Records

Example - Expedia/Hotels.com Traditional Lodging Property

This is an example of a lodging property available via Expedia and Hotels.com websites.

{
  "propertyId": {
    "expedia": "55",
    "hcom": "116944",
    "vrbo": ""
  },
  "bookable": {
    "expedia": true,
    "hcom": true,
    "vrbo": false
  },
  "propertyType": {
    "id": 1,
    "name": "Hotel"
  },
  "inventorySource": "expedia",
  "starRating": "2.5",
  "referencePrice": {
    "value": "58.65",
    "currency": "USD"
  },
  "chainAndBrand": {
    "chainId": -5,
    "chainName": "Hilton Worldwide",
    "brandId": 358,
    "brandName": "Hampton Inn"
  },
  "vrboPropertyType": {
    "instantBook": false,
    "quoteAndHold": false
  }
}

Items to Note:

propertyId — There are IDs for both Expedia and Hotels.com, but not for Vrbo yet.
bookable — This listing is bookable via both Expedia and Hotels.com sites, but not via the Vrbo site yet. As inventory migrations complete, there will be more commonality between where all inventory will be available, and these changes will be updated in the data feeds as they occur.
starRating and referencePrice — Both of these optional elements are included in this listing because it is a traditional lodging property. They will be missing for most vacation rental properties.
propertyType — This data element allows you to include/exclude entire groups of properties.

Example - Vrbo Vacation Rental Property

This is an example of the data returned for a vacation rental property that is currently bookable only on the Vrbo website.

{
  "propertyId": {
    "expedia": "33554955",
    "hcom": "1074758560",
    "vrbo": "121.4277376.4685943"
  },
  "bookable": {
    "expedia": false,
    "hcom": false,
    "vrbo": true
  },
  "propertyType": {
    "id": 17,
    "name": "Private vacation home"
  },
  "inventorySource": "vrbo",
  "starRating": "0",
  "referencePrice": {
    "value": "0",
    "currency": "USD"
  },
  "vrboPropertyType": {
    "instantBook": true,
    "quoteAndHold": false
  }
}

Items to Note:

propertyId — Notice that the property has IDs for all websites, even though it is currently only bookable on Vrbo.
starRating — Vacation rental properties do not get star ratings, so this will always be blank in that case. Look for Guest Rating if you'd like to display rating information.
referencePrice — If the property has not yet been sold on Expedia it will not have a reference price. This data should eventually be populated, but only once the property is more widely available to book. Reference pricing will most likely never be as widely available for vacation rentals as it is for traditional loding, since many VRs are not booked as frequently and, therefore, may not have a recently booked price amount to quote.
vrboPropertyTypes — This element is only useful if you are linking the user to the Vrbo site to book. At first release, there is no Quote and Hold inventory included, but that inventory will flow through over time.