Feeds for hotels are supported in XML and CSV/TSV formats. See below for sample files.
Required fields
hotel_id
Type: string
Description: Unique identifier of the hotel in the catalog
Requirements/Constraints:
- Maximum allowed number of characters: 128.
- The product ID must be unique within one product feed.
- The product ID can include all characters of the Latin alphabet in upper and lower case, underscores and hyphens, as well as numbers.
Example: 322223
name
Type: string
Description: Hotel name
Requirements/Constraints: Maximum allowed number of characters: 256
Example: IBIS Dynamo Moscow
url
Type: string
Description: Link to an external site where you can book a hotel room
Requirements/Constraints: Links must be working, start with http:// or https:// and be placed on the domain of your company website. They must lead to the correct service page
Example: https://example.ru/
image
Type: string
Description: Image of the hotel
url
(nested in image)
Type: string
Description: URL of the hotel image
Requirements/Constraints:
- Acceptable image file formats are JPEG, PNG, GIF, WEBP.
- Recommended size: 600 pixels on the largest side.
- Minimum size: 300 pixels on the largest side.
- Maximum size: 6000 pixels on the largest side.
- The background of the image should be monochrome, we recommend using white colour for the background.
- The image should only show the product itself without any additional inscriptions, watermarks or logos.
The image of the product must comply with Rules for Placing Advertisements.
Example: http://example.com/some.image_1.jpg
Note! When updating an image, be sure to change the link to it, otherwise the changes will not be recognized.
location
Type: string
Description: Location of the hotel
address
(nested in location)
Type: string
Description: The main address of the hotel
Requirements/Constraints: Maximum allowed number of characters: 256
Example: 35 Green St.
locality
(nested in location)
Type: string
Description: Settlement where the hotel is located
Requirements/Constraints: Maximum allowed number of characters: 256
Example: St. Petersburg
region
(nested in location)
Type: string
Description: Region where the hotel is located
Requirements/Constraints: Maximum allowed number of characters: 256
Example: St. Petersburg
country
(nested in location)
Type: string
Description: Country where the hotel is located
Requirements/Constraints: Maximum allowed number of characters: 256
Example: Russia
price
Type: string
Description: Cost of hotel accommodation
Requirements/Constraints:
- Price as a number with the three-letter ISO 4217 currency code separated by a space.
- Use a period (.) as the decimal separator, not a comma (,).
- Do not use $, €, or £ symbols to represent currency.
Supported currency codes:
- RUR or RUB: Russian Ruble
- USD: US dollar
- EUR: euro
- UAH: Ukrainian grivna
- BYN: Belarusian ruble
- KZT: Kazakh tenge
- MDL: Moldovan Leu
- AZN: Azerbaijani manat
- UZS: Uzbek soum
- AMD: Armenian Dram
- TJS: Tajik Somoni
- KGS: Kyrgyz som
Example: 1000000 RUB
Optional fields
metro
Type: string
Description: Nearest metro station
name
(nested in metro)
Type: string
Description: Name of metro station. Can be up to 4 stations. Each station in separate <metro> tag
Requirements/Constraints: Maximum allowed number of characters: 256
Example: Udelnaya
category
Type: string
Description: Type of hotel. Valid values:
- Hotel
- Hostel
- Apartment
- Guest House
- Cottage
- Villa
- Bungalow
- Camping
- Glamping
Requirements/Constraints: Maximum allowed number of characters: 256
Example: Hotel
sale_price
Type: int
Description: Discounted price per night
Requirements/Constraints: Price as a number with a three-letter ISO 4217 currency code, separated by a space
Example: 3000 RUB
min_price
Type: int
Description: Minimum price. When adding the minimum price of the product in the banner, the preposition "from" is specified before the price
Requirements/Constraints: Maximum allowed number of characters: 256
Example: 3000 RUB
max_price
Type: int
Description: Maximum price. When adding the minimum price of the product in the banner, the preposition "to" is specified before the price
Requirements/Constraints: Maximum allowed number of characters: 256
Example: 3000 RUB
description
Type: string
Description: Short description of the hotel
Requirements/Constraints: Maximum allowed number of characters: 256
Example: Hotel in the center of Moscow
brand
Type: string
Description: Hotel chain brand
Requirements/Constraints: Maximum allowed number of characters: 256
Example: Moscow Hotels
custom_label
Options: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
Type: string
Description: Custom fields with additional information. Used when creating product groups.
Requirement/Constraint: Max allowed number of characters: 256
Example: Summer sale
guest_rating
Type: string
Description: User rating of the hotel
score
Nested in guest_rating
Type: float
Description: User rating of the hotel
Requirements/Constraints: Use a positive float number between 1 and 10 inclusive
Example: 5.1
Required fields for mobile apps
android_tracking_url
Type: string
Description: Tracking link for Android
Requirements/Constraints:
- Links must be valid, starting with http:// or https://
- Acceptable domains depending on the application tracker used
- MyTracker: trk.mail.ru
- Adjust: app.adjust.com
- Appsflyer: app.appsflyer.com
- AppMetrica: redirect.appmetrica.yandex.com
Example: https://app.appsflyer.com/goldapple.ru.goldapple.customers?pid=mail.ru_int
ios_tracking_url
Type: string
Description: Tracking link for iOS
Requirements/Constraints:
- Links must be valid, starting with http:// or https://
- Acceptable domains depending on the application tracker used
- MyTracker: trk.mail.ru
- Adjust: app.adjust.com
- Appsflyer: app.appsflyer.com
- AppMetrica: redirect.appmetrica.yandex.com
Example: https://app.appsflyer.com/id1154436683?pid=mail.ru_int
android_package
Applink field attribute
Type: string
Description: Identifier of the Android application
Requirement/Constraints: none
Example: <applink property="android_package" content="myapp_package"/>
ios_app_store_id
Applink field attribute
Type: string
Description: Identifier of the iOS application
Requirement/Constraints: none
Example: <applink property="ios_app_store_id" content="111222333"/>
android_url
Applink field attribute
Description: Deep link for Android
Requirements/Constraints:
URL schemas of mobile_android_app_link and mobile_ios_app_link fields must match
The deep link must open correctly (valid)
Example: <applink property="android_url" content="myapp://product/01.00.01.1-1.0.8-8.25.3"/>
ios_url
Applink field attribute
Type: string
Description: Deep link for iOS
Requirements/Constraints:
URL schemas of mobile_android_app_link and mobile_ios_app_link fields must match
The deep link must open correctly (be valid)
Example: <applink property="ios_url" content="myapp://product/01.00.01.1-1.0.8-8.25.3"/>
Example of a catalog for hotels – XML
<?xml version="1.0" encoding="UTF-8"?><listings> <title>My Hotel Feed</title> <listing> <hotel_id>1234</hotel_id> <name>The best hotel</name> <description>A very nice hotel</description> <brand>Premium_brand</brand> <price>1990.99 RUB</price> <phone>+61 2-96027455</phone> <location> <address>ул. Разбитых Фонарей д.1</address> <region>Самарская область</region> <country>Россия</country> <locality>Самара</locality> <metro> <name>Удельная</name> </metro> </location> <image> <url>http://example.com/image_1.jpg</url> </image> <guest_rating> <score>5.1</score> </guest_rating> <url>http://www.thebesthotel.com</url> <applink property="ios_url" content="example-ios://electronic" /> <applink property="ios_app_store_id" content="42" /> <applink property="android_url" content="example-android://electronic" /> <applink property="android_package" content="com.electronic" /> <ios_tracking_url>https://app.adjust.com/abcd?campaign=&creative=&deep_link=ozon://products/105207/</ios_tracking_url> <android_tracking_url>https://app.adjust.com/abcd?campaign=&creative=&deep_link=ozon://products/105207/</android_tracking_url> </listing></listings>