Property Descriptions

File Content and Purpose

This file contains a description of the area in which the property is located, a description of the property itself, and any closure or renovation information about the property.

File Format

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

• Download SAMPLE Descriptions Data File

Complete File Download

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

• Download COMPLETE Descriptions Data File

Sample Property Description Record

{
    "propertyId": {
      "expedia": "49109585",
      "hcom": "1572506720",
      "vrbo": "321.1941609.2504131"
    },
    "propertyType": {
      "id": 16,
      "name": "Apartment"
    },
    "country": "Mexico",
    "areaDescription": "This apartment is located in Cuauhtemoc, a neighborhood in Mexico City. Paseo de la Reforma and Plaza Satelite Shopping Center are worth checking out if shopping is on the agenda, while those wishing to experience the area's natural beauty can explore Chapultepec Park and Alameda Central. Looking to enjoy an event or a game? See what's going on at Auditorio Nacional or Autodromo Hermanos Rodriguez. ",
    "propertyDescription": "Departamento a solamente dos minutos del Angel de la Independencia. Excelente para viajes de trabajo o familiar. Excelente ubicación en calle tranquila. Muy cómodo para salir caminando. Edificio recién construido.

Muchos restaurantes por la zona, además de estar a dos minutos de Paseo de la Reforma (Avenida más importante de México) a la altura del Angel de la Independencia. Además encontrarás parques, comercios, en la zona más céntrica de la Ciudad de México."
  }

Items to Note

• Vrbo Data — At launch, there is currently very little description data for Vrbo properties. These will flow in over time as Expedia completes merging lodging inventory.
• areaDescription — Talks about what is around the property.
• propertyDescription — Talks about what the property contains.
• renovationsAndClosure — May be leveraged to provide Covid-related information that will impact guest experience.