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
accommodation type	Specific accommodation's category. E.g. "villa", "house", "service apartment"	true
category	A hotel's star category	true
longitude	Longitude of the hotel	true
latitude	Latitude of the hotel	true
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

Additional fields for Alternative Accommodations

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	true
longitude	string	Longitude of the hotel	true
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

Additional fields for Alternative Accommodations