Hotels
Eligible sites
Aggregators and lodging sites.
Note
Hereinafter, "lodging" means a hotel, campground, glampground, or guest house.
What it adds to search results
Photos, names, addresses, ratings, prices, amenities, and placemarks of the lodgings. When a user is looking for lodging options, Yandex Search can show them a carousel of lodging cards that best match the query. The buttons above such an answer enable the user to refine their query (for example, change the dates or the number of guests) without leaving the search results page. The user can also expand the map and choose a lodging based on its location.
How to set it up
Register your lodging with one of these aggregators:
- 101Hotels.com
- Hotelofficial
- Ostrovok.ru
- Tutu.ru
- Tvil.ru
- Otello
- Yandex Travel. For integration, register with Travelline or Bnovo and place their booking module on your site. See Yandex Travel for partners to learn more.
After registering with an aggregator, entities that provide lodging services can output information about the lodging and about the availability of rooms for specific date ranges, including the cost.
Cards may also be displayed for lodgings that aren't registered with an aggregator, but they will contain only the organization's general details, without information about the prices and room availability.
In this case, to make a card with information about a lodging appear:
-
Go to the Organizations page.
-
Click the Add button and fill in the fields.
You can also link a company that already has a profile on Yandex to your website. To do this, go to the profile, find the organization editing form, and specify the website address to which you want to link this information in the Website field.
For integration as an aggregator:
-
Use the form below to submit an integration request.
Submit a request
-
Wait until a Yandex representative contacts you using the contact details you provided in the form.
Enter into an agreement with Yandex (will be provided by the representative). Please note that the integration is subject to a fee.
-
Prepare the technical integration and start regularly transmitting the following data via the API: information about the hotels, room availability and rates, and the bookings made by people who went to the aggregator site from universal search results.
Alert
An access token is required for using the API. Ask the representative assigned to you for the token.
-
Provide your organization's logo for display in the dedicated section.
Format: a vector icon, SVG.
-
Check if the integration was successful.
How the integration works
- The aggregator passes data about the lodgings, availability for date ranges, and room rates via the API in advance. The data is automatically compared with the data from other aggregators that are integrated with the dedicated sections.
- The data received from aggregators is used to generate a section with offer prices for each lodging. The offers are displayed to the user in ascending order (the lowest price is shown at the top). Each lodging can have no more than three offer prices displayed*.
- Clicking a link in the dedicated section open the aggregator's landing page with a description of the lodging option for this date range and this number of guests. If no date range is specified, the default context is used: a one-night stay two days after the current date.
- If the user makes a booking after following the link, the aggregator passes information about that booking via the API.
* For popular destinations, the user may see aggregators' offer prices without selecting dates, right after the search. For less popular destinations, the user may need to select the check-in and check-out dates.
Note
If a hotel on the aggregator site isn't correctly matched with a hotel in Yandex Business, you can report the error using an XLSX file.
Aggregator requirements:
-
The aggregator is responsible for ensuring that the data is accurate and the offers are relevant. They are also accountable for spreading illegal information. If the terms are violated, Yandex reserves the right not to use the site's data for displaying answers in search results. See the detailed conditions.
-
The offer conditions shown in search results are final and can't change after the booking is made.
-
Instant booking: the user instantly receives a confirmation after making a booking. The booking is made directly on the partner site, without other sites opening, after the user enters the required information on the partner site. The booking is completed with the partner's confirmation, which is also made on the partner site.
Instant booking shouldn't require the user to go to other sites or communicate with the partner in chats, over the phone, or via other channels to finalize or confirm the booking.
Instant booking applies to all lodgings listed on the partner's site.
-
The aggregator provides support to users through the functionality implemented on the site or specifies the aggregator's contact details on the site.
-
The partner site doesn't violate the rights of third parties. Specifically, it doesn't replicate or copy any sites of rights holders.
-
The aggregator is a legal entity or sole proprietor.
-
The aggregator's activities comply with the law of the country where it is registered.
-
The aggregator must have a desktop version and a mobile version.
-
The aggregator must provide all necessary functionality for the user to view the information about a lodging and for processing advance payments.
Cashback display
Lodging cards with lists of partner offers in search results can display cashback amounts for booking and paying for lodging services. That cashback can be used for future purchases. One example of cashback is bonus points awarded by the booking service.
Display example
For cashback amounts to be displayed in lodging cards, provide Yandex with information about the programs which reward cashback and about the users eligible for these programs. The information is passed via the API.
Connection terms and conditions
Cashback can be displayed in the card if the following conditions are met:
- Cashback is rewarded for the current booking.
- One cashback point is equivalent to one ruble.
How to enable enhanced appearance
Step 1. Prepare the user data
-
- Use the API to pass the data about cashback and the user categories you want to show cashback to.
- Make sure that the data is updated at least once a day.
Step 2. Pass the data to Yandex
-
-
Fill out the application form specifying:
- The partner's name (must be an existing partner).
- The user categories that qualify for cashback.
- A short description of the cashback program (the program's name, what one bonus point is equivalent to, and the like).
-
Add your program's favicon. It will be displayed in lodging cards.
- Favicon requirements
-
- Format: SVG (recommended), ICO, GIF, JPEG, PNG, and BMP.
- Animation is not supported.
- Size: 120 × 120, 32 × 32, or 16 × 16 pixels.
Apply for enabling cashback display
-
How user information is used by hotel search
By default, cashback can be shown to users who are already participating in the cashback program at the time of viewing the hotel card.
Hashing user information
When you prepare the data, use the MD5 algorithm for hashing. Each record must be hashed separately.
Field |
Description |
|
The user's phone number. A numeric string containing a phone number with a country code. Spaces and additional characters are not allowed.
|
|
The user's email address. A string of Latin characters with the @ sign and a domain name. Uppercase letters are not allowed.
|
An example of records with hash values:
phone_hash,emails_hash
a31259d185ad013e0a663437c605d056,78ee6d68f49d2c90397d9ff77fc3814d1
702e8494aeb560dff987eh623e71ccf8,f5ge43thaeb67df89875777e71bccf88i
Page updated: April 30, 2025.
Change history
- Updated information on instant booking for aggregators.