List of hotels

The hotel list is an XML file that specifies the hotels for which you want to submit data. The XML file doesn't specify accommodation costs. Price information is submitted via the API.

Integration scheme

  1. The partner creates an XML file listing hotels and hosts it on their website.
  2. The partner then submits a connection request, providing a link to this XML file.
  3. When a partner is connected, the hotels listed in their XML file are linked to corresponding entries in Yandex Business Directory. The linking process takes up to two weeks. Once complete, the partner can receive a list of hotels successfully linked to entries in Yandex Business Directory.
  4. The robot downloads the partner's hotel list once a day using an HTTP GET request.
  5. The partner transfers hotel data via the API.

Requirements for XML files

  • The text file must be in .xml format. For example, hotel-list.xml.

  • A single file can't exceed 100 MB. If your file is larger, split it into multiple files.

  • The file must be crawlable by search robots. Make sure that the file's link isn't blocked from indexing and that the server returns an HTTP 200 OK status.

    Check the file's link availability and the server's response in Yandex Webmaster.

How to create an XML file

Sample file


  <?xml version="1.0" encoding="UTF-8"?>
  <listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
    <language>tr</language>
    <listing>
      <!-- The value of <id> must always be unique to your site. Do NOT reuse IDs. -->
      <id>Hotel123</id>
      <name>Hotel Houston</name>
      <address format="simple">
        <component name="addr1">Cumhuriyet Mah., 703</component>
        <component name="addr2">Sok., No:1/101</component>
        <component name="city">Antalya</component>
        <component name="region">Antalya</component>
        <component name="postal_code">07010</component>
      </address>
      <country>TR</country>
      <latitude>36.900000</latitude>
      <longitude>30.683330</longitude>
      <category>hotel</category> <!-- You can use any property type categories -->
    </listing>
    ...
  </listings>

Attributes of the "listings" element

The listings element contains the following required attributes:

Attribute

Description

xmlns:xsi

Specify: http://www.w3.org/2001/XMLSchema-instance.

xsi:noNamespaceSchemaLocation

Specify: http://www.gstatic.com/localfeed/local_feed.xsd.

Field descriptions

Element

Type

Description

Elements within listings

language*

string

Language of the submitted data. Specify the two-character code in ISO 3166-1 format. For example, tr for Turkish.

listing*

listing

Hotel information.

Elements within listing

id*

string

Your hotel's unique ID. Use this ID only for this specific hotel. Don't reuse it for other hotels, even if those are in a separate XML file.

name*

string

The hotel's name. For example, <name>Citrus Park Hotel</name>.

address*

Object or string

Physical address of the hotel. The element takes one attribute, format, which must be set to simple.

Specify the hotel's address, city, province, region, and ZIP code. Use the child elements <component> to describe the following address parts:

  • addr1: Primary hotel address.

  • addr2: Optional secondary address 1.

  • addr3: Optional secondary address 2.

  • city: Name of the city where the hotel is located.

  • province: Name of the province where the hotel is located.

  • region: Name of the region where the hotel is located.

  • postal_code: ZIP code of the hotel.

For example:


<address format="simple">
  <component name="addr1">Cumhuriyet Mah., 703</component>
  <component name="addr2">Sok., No:1/101</component>
  <component name="city">Antalya</component>
  <component name="province">Antalya</component>
  <component name="postal_code">07010</component>
</address>

country*

string

Country where the hotel is located. Specify the two-character ISO 3166 country code. For example, Türkiye is TR, and Russia is RU.

latitude*

float

Geographical latitude of the hotel. For example, <latitude>41.006592</latitude>.

longitude*

float

Geographical longitude of the hotel. For example, <longitude>28.974537</longitude>.

You can find the coordinates in map apps like Yandex Maps.

phone

string

Phone numbers of the hotel. You can specify one or more, defining their type with the type attribute.

Possible values of the type attribute:

  • main: Main phone number.

  • mobile: Mobile phone number.

  • tdd: TDD (telecommunications device for the deaf) phone number.

  • tollfree: Toll-free phone number.

For example:

<!-- Türkiye (country code +90) -->
<phone type="main">90-242-1234567</phone>

category

string

Property type. For example, hotel. You can use any internal categories to describe your property, such as "business hotels", "resorts", "motels", "villas", and others.

content

string

More hotel details: description, amenities, rating.

* — Elements marked with an asterisk are required.

Previous
Hotels
Next
API for getting prices