"Facts" about accommodations

We collect more structured meta data about accommodations, we call them "Facts". Facts are available through our API and can be displayed on your website. Facts also optimize your site for search engines.

In this guide, we'll explain you how to get and make use of "Facts"

Requirements

Currently, we only provide facts for Apartments. "Facts" is a well-defined data structure attached to Accommodation objects, which you retrieve with GET /accommodations.

This is an example of a facts object for "Les Bouleaux" Apartment in Nendaz:

{ 
    "type": "apartment",
    "name" : {
        "de": "Les Bouleaux"
    },
    "city": "Nendaz",
    "facts" : {
        "apartment" : {
            "bedrooms" : 1, 
            "maxAdults" : 2, 
            "sqm" : 25, 
            "type" : "apartment"
        }
    }
}

Structure of the `facts` objects

The facts object always contains one key with the name of the accommodation type. For an accommodation of type apartment, facts contains at least a key named apartment, and so on.

Available facts

apartment:

bedrooms: Number of bedrooms
maxAdults: Maximum number of adults for this apartment
maxChildren: Maximum number of children for this apartment
sqm: Square meters of the apartment
type: Apartment-subtype, possible values:

chalet
apartment
farmhouse
rustico

Users of the Whitelabel UI

Facts are already displayed in our Whitelabel UI, as seen in the following example:

Users of the JavaScript SDK

If you use our JavaScript SDK, facts are already part of the accommodation objects you get with getAccommodations()et al.

Limits

Currently, we only provide facts for Apartments.