Get "Facts" about your accommodation

Search…

Since Aug. 2016 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:
https://d16co4vs2i1241.cloudfront.net/uploads/tutorial_image/file/608283634473895832/b79434e18f984b435bda26af028e2fbb1d0b560234071652c5ab220e258a9f72/column_sized_unspecified.png
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.

Special Topics - Previous

How to get From/Minimum prices?

Next - Special Topics

Extending Data with Hooks

Last modified 2yr ago

Copy link

On this page

Requirements

Structure of the facts objects

Available facts

Users of the Whitelabel UI

Users of the JavaScript SDK

Limits