Summary Data

File Content and Purpose

This file contains a full list of all lodging properties available for booking via Expedia Group websites, including:

Expedia Properties
Hotels.com Properties
Vrbo Properties

There are ~5 million properties listed in this file, but not all properties are available to book on all websites at this time, so partners must be careful to filter the file according to the bookability on the site to which they plan to direct users for booking. This also applies to partners booking via API, as the brand under which you are booking will determine which properties you can and cannot book.

Note: If you are uncertain about which brand your API access is configured under, try making an XAP Lodging Search API query that returns a deeplink. The deeplink URL will tell you which site your are configured on.

File Format

The download file is a single zip file named expedia-feed.jsonl.zip. Note that this is the MVP name and that name/URL path will change as we add support for additional languages. Inside the .zip file you will find 5 compressed .jsonl files, which contain ~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 5 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

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 Summary File download:

Complete File Download

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

Download COMPLETE Summary Data File

Data Record Samples

Example - Expedia/Hotels.com Traditional Lodging Property

This is an example of the data returned for a traditional lodging property (standard hotel) that is bookable on Expedia or Hotels.com.

{
    "propertyId": {
      "expedia": "33554963",
      "hcom": "",
      "vrbo": ""
    },
    "bookable": {
      "expedia": false,
      "hcom": false,
      "vrbo": false
    },
    "propertyType": {
      "id": 16,
      "name": "Apartment"
    },
    "guestRating": {
      "expedia": {
        "avgRating": "0"
      },
      "hcom": {
        "avgRating": "0"
      },
      "vrbo": {
        "avgRating": "0"
      }
    },
    "referencePrice": {
      "value": "0",
      "currency": "USD"
    },
    "lastUpdated": "",
    "propertyName": "INMAN PARK DEGRESS 2 BEDROOM",
    "address1": "183 Degress Ave NE",
    "address2": "",
    "city": "Atlanta",
    "province": "Georgia",
    "country": "United States",
    "postalCode": "30307",
    "geoLocation": {
      "latitude": "33.759",
      "longitude": "-84.352",
      "obfuscated": false
    },
    "starRating": {
      "rating": "0"
    }
  }

Items to Note:

propertyId — The property has an Expedia propertyId and a Hotels.com propertyId, but no Vrbo propertyID.
bookable — The property is bookable on Expedia and Hotels.com websites, but is not bookable on the Vrbo site.
guestRating — Because it's not yet bookable on the Vrbo site, there are no Vrbo guest ratings.

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": "64989264",
      "hcom": "2080656448",
      "vrbo": "121.9550241.8629938"
    },
    "bookable": {
      "expedia": false,
      "hcom": false,
      "vrbo": true
    },
    "propertyType": {
      "id": 14,
      "name": "Villa"
    },
    "guestRating": {
      "expedia": {
        "avgRating": "0"
      },
      "hcom": {
        "avgRating": "0"
      },
      "vrbo": {
        "avgRating": "0"
      }
    },
    "referencePrice": {
      "value": "0",
      "currency": "USD"
    },
    "lastUpdated": "",
    "propertyName": "Nestled in Natural Stone Walkway 3Br Villa With Pool",
    "address1": "Little Bay Road",
    "address2": "",
    "city": "East End",
    "province": "East End",
    "country": "British Virgin Islands",
    "postalCode": "",
    "geoLocation": {
      "latitude": "18.452",
      "longitude": "-64.573",
      "obfuscated": false
    },
    "starRating": {
      "rating": "0"
    }
  }

Items to Note:

propertyId — The property has an Expedia propertyID, but is not bookable on Expedia. This is not a mistake. The property has been migrated into our content system, but is not yet live in the sales system. The customer cannot book it on the Expedia site, but they can on the Vrbo site.
bookable — Always use this value to tell you whether the property is bookable or not. Even though it has a propertyId for a particular brand, that does not tell you whether that property is bookable on that brand, only the bookable value tells you that.
propertyType — If you want to include or exclude a particular type of properties (such as vacation rentals or hostels) filter on this value.
guestRating — Since it's not bookable on Expedia or Hotels.com, there are no ratings from people that have booked.
geoLocation/obfuscated — This property owner does not want their exact location communicated until you book, so the obfuscated value tells you that the latitude and longitude values are not exact.
address1 — The house number is missing from address1 value. Many vacation rental property owners require that the exact address of the property be communicated to the guest only after booking, but may not be published beforehand. Since we have obfuscated any required values already, the value that is returned in the address1 element may be displayed on your site as-is without additional changes.
starRating — Vacation rental properties do not receive official star ratings like traditional hotels do, so this field should be blank for all Vacation Rental properties.