Hotel data

Before running a campaign, advertisers need to provide an import feed containing all hotels they want to be advertised on trivago. trivago will import the advertiser's hotel inventory into the trivago database and based on the provided data, the hotels will be mapped to the corresponding trivago properties. It is important that we receive a complete inventory list that contains all of your bookable hotels. The quality of your data will strongly impact the matching ratio and quality. Once the initial inventory feed has been imported successfully, advertisers can make adjustments to their inventory by providing a new feed.

Provide hotel data as .csv

The most simple way to import the inventory is to provide the data as .csv file. In that case please provide a static download link from where the .csv file can be retrieved.

Example download link:

https://advertiser-site.com/hotels/inventory/hotel_data.csv

the .csv needs to be in a specific format. Please find below a list of columns which can be provided in the inventory feed.

Field Description Mandatory
Download sample
partner_reference The advertiser's unique hotel identifier true
name The name of the hotel true
address The address of the hotel true
address2 Additional part of the hotel's address false
postcode Postcode of the hotel true
city City of the hotel true
state State of the hotel true (only for US hotels)
country Country of the hotel true
country_id Corresponding country id false
longitude Longitude of the hotel false
latitude Latitude of the hotel false
phone Phone number of the hotel false
fax Fax number of the hotel false
web Website of the hotel false
e-mail E-mail of the hotel false
currency Accepted currency in the hotel false

Download sample
accommodation type Specific accommodation's category. E.g. "villa", "house", "service apartment" true
number of units Number of units the unique partner reference is referring to false
unit size Numeric size of the unit in square feet or meters false
unit type Square feet or square meters false
unit occupancy Number of guests allowed per unit false
number of bedrooms Number of bedrooms per unit false
number of bathrooms Number of bathrooms per unit false
floor number Number of floor where the unit is located false
unit number House or apartment number false
owner / property manager Owner or property manager's name false

Provide hotel data through your API

If you prefer to provide the hotel data through your API, trivago expects your API to reply to a GET request sending a response with the structure explained below.

Request

Sample code

Header:

Content-Type: application/x-www-form-urlencoded

Endpoint:

https://advertiser-site.com/api_implementation/hotel_data

Response

Sample code

Header:

Content-Type: application/json

Body:

{
    "api_version" : 4,
    "lang" : "en_GB",
    "hotels" :
        [
            {
                "partner_reference" : "5568",
                "name" : "Hotel Adlon",
                "street" : "Unter den Linden 77",
                "city" : "Berlin",
                "postal_code" : "10117",
                "state" : "NRW",
                "country" : "Germany",
                "latitude" : 52.516240,
                "longitude" : 13.380437,
                "desc" : "Welcome to the hotel Adlon Kempinski, a hotel full of tradition and elegance in the heart of the city center.",
                "amenities" : ["Beauty Center", "Business Center", "Café/ Bistro", "Sauna"],
                "url" : "https://advertiser-site.com/hoteladlon",
                "email" : "adlon@adlon.com",
                "phone" : "030-123123",
                "fax" : "030-12341234"
            }
        ]
}

Response parameters

Field Type Description Mandatory
api_version string Version of the API false
lang string Language of description elements false
hotels array of hotel objects The actual inventory true

JSON Objects

Hotel

Field Type Description Mandatory
partner_reference string Unique partner reference of the hotel true
name string Name of the hotel true
street string Address of the hotel true
city string City of the hotel true
postal_code string Postcode of the hotel true
state string State of the hotel true (only for US hotels)
country string ISO 3166 country code true
latitude string Latitude of the hotel false
longitude string Longitude of the hotel false
desc string Description of the hotel false
amenities string array Amenities that are generally available at the hotel, not specific to a room. Each string is free text which should be in the language indicated by the 'lang' parameter false
url string URL of the hotel false
email string Email address of the hotel false
phone string Phone number of the hotel false
fax string Fax number of the hotel false

accommodation_type string Specific accommodation's category. E.g. "villa", "house", "service apartment" true
number_of_units integer Number of units the unique partner reference is referring to false
unit_size float Numeric size of the unit in square feet or meters false
unit_type string Square feet or square meters false
unit_occupancy integer Number of guests allowed per unit false
number_of_bedrooms float Number of bedrooms per unit false
number_of_bathrooms float Number of bathrooms per unit false
floor_number integer Number of floor where the unit is located false
unit_number integer House or apartment number false
owner / property_manager string Owner or property manager's name false