Realty

Eligible sites

Sites for renting and selling property.

What it adds to search results

A selection of ads for apartments in a specific residential complex. The following details are included: the housing development location, number of bedrooms, prices, size, and number of available housing units. The user can quickly go to the options they like.

Contains ads from a partner site that match the user's query. The following ad details are displayed: the price, photo, size, and number of rooms. The user can see important information at a glance and quickly open the options they like.

How to set it up

To include your offers in such responses, send information about them to Yandex. To do this, prepare a feed in the YML format. The YML standard was developed by Yandex and is based on the XML standard. A feed is a file which you send information about your products in. It contains offers combined into sets.

A set differs from another mandatory feed element — the category (category). There can be only one category. There can be more than one set, since the same offer can be included in different sets. The sets where the offer is included are placed in a list separated by commas.

The snippet added in the search results has the URL specified in the set. The snippet contains information about the offers included in the set. The offer format must meet certain requirements. All additional information about the offer is specified in the param element — a universal element with text content.

Feed restrictions

YML file size

200 MB

Total number of images

50,000

Number of images in one offer element

200

Number of offer elements

30,000. Data from a feed containing more offers will not be used for additional representation. The feed itself will load with an error. To have offers participate in the search, split the feed into several parts.

Don't include offers with the same URL in multiple feeds, and don't move offers from one feed to another: the data from the moved offer may temporarily disappear from search results.

Number of elements set

1 million

The total number of all YML files (product feeds, service and offer feeds, RSS for content Turbo pages) for the site and its subdomains

1000

Tip

You don't need to format a file for all content and include all offers.
It is enough to include only those sets (URLs) that need to be added in the search results.

Feed requirements

A feed can contain different offer types:

  • A specific offer. For example, a particular apartment or office.
  • A selection. For example, "Sunset Bay Residential Complex" or "1-bedroom apartments in Abakan". Details: the minimum price, number of ads in the selection, address, and other parameters that characterize the entire selection.

The URL of a selection offer can be the same as the URL of a set in the feed. Example:

  • The set "Buy an apartment in Abakan" contains a "1-bedroom apartments" offer.
  • The set "Buy 1-bedroom apartments in Abakan" (with the same URL as the "1-bedroom apartments" offer) contains a "Mira Street, 31 m2" offer.

Feed example

If your site has ads about renting or selling new-builds and existing homes, for convenience, you can create separate feeds for each type.

Offer elements

Minimum set of offer elements; the required ones are marked with an asterisk:

Element

Note

name *

The name of the offer.

url *

The URL of the offer. Must be unique among all offers within all feeds of the same region. Tags (for example, UTM, Openstat, from) don't make the URL unique.

price *

Cost. You can use the from="true" attribute to specify that it's the minimum salary.

currencyId *

Currency ID. For example, RUR for rubles.

categoryId *

Category ID.

set-ids *

Set IDs. You can list several sets separated by commas, for example: s1,s2,s3.

picture *

Up to 10 photos of the property. The links shouldn't have duplicates in the offers, but you can upload identical photos with different links.

param name="Конверсия" (Conversion) *

Number. An arbitrary value. The higher it is, the better the offer is.

param name="Тип предложения" (Offer type) *
  • "Продажа" (sale)
  • "Аренда" (rental)

vendor

Name of the developer or seller.

description

Description.

param name="Посуточно" (Daily rate)

true or false (by default).

param name="С земельным участком" (With a land lot)

true or false (by default).

param name="Площадь участка" (Land lot size)

By default, a value in square meters (m2) is expected, but you can use the unit="сотки" attribute to specify a value in ares.

param name="Число объявлений" (Number of ads)

Number. The presence of this field means that the offer is a selection.

param name="Число отзывов" (Number of reviews)

Number.

param name="Ссылка на отзывы" (Link to reviews)

String.

param name="Сайт застройщика" (Developer's site)

String.

param name="Минимальная ипотека" (Minimum mortgage)

Number.

param name="Рынок жилья" (Home type)
  • "Первичный" (new-build)
  • "Вторичный" (existing)

param name="Класс жилья" (Housing class)
  • "Эконом" (Economy)
  • Business
  • "Элитный" (Upmarket)
  • "Комфорт" (Comfort)
  • "Комфорт+" (Comfort+)
  • "Премиум" (Premium)

You can list multiple values, separating them by commas.

param name="Адрес" (Address)

String.

param name="Широта" (Latitude)

Number with decimal places.

param name="Долгота" (Longitude)

Number with decimal places.

param name="Год постройки" (Year of construction)

Number.

param name="Этаж" (Floor)

Number.

param name="Число этажей" (Number of floors)

Number.

param name="Число комнат" (Number of rooms)

Number. For a studio apartment, enter 0.

param name="Свободная планировка" (Open plan)

true or false (by default).

param name="Площадь" (Area)

Number. In m2.

param name="Дата публикации" (Posting date)

Date in ISO 8601 format.

param name="Размещено агентом" (Posted by an agent)

true or false (by default).

param name="Проверено в ЕГРН" (Verified through EGRN)

true or false (by default).

param name="Расстояние до метро" (Distance to metro station)

Number. In minutes. The unit attribute can be set to Пешком (on foot) or Транспортом (by transport).

param name="Тип парковки" (Parking space type)
  • "Отдельная" (private)
  • "Охраняемая" (guarded)
  • "Рядом" (nearby)
  • "Подземная" (underground)
  • "Многоуровневая" (multistory)
  • "Наземная" (surface)
  • "Открытая" (outdoor)
  • "Закрытая" (indoor)

You can list multiple values, separating them by commas.

param name="Отделка" (Fit-out)
  • "Черновая" (shell and core)
  • "Чистовая" (white box)
  • "Под ключ" (turnkey)

You can list multiple values, separating them by commas.

param name="Ремонт" (Renovation)
  • "Косметический" (facelift)
  • "Евро" (western style)
  • "Дизайнерский" (designer project)
  • "Требуется" (currently required)

param name="Включая коммунальные услуги" (Utilities included)

For rental offers. Possible values: true or false (default).

param name="Сайт объекта" (Property's site)

String.

param name="Телефон объекта" (Property's phone number)

String.

param name="Название риелтора" (Real estate agent's name)

String.

param name="Телефон риелтора" (Real estate agent's phone number)

String.

param name="Логотип риелтора" (Real estate agent's logo)

String.

You can create your own optional param elements. Some information from these elements may not be displayed in the current enriched output formats. But this information will be taken into account in the future when ranking offers in the set and may appear in new enriched output formats.

Image requirements

  • The image should be of high quality, without blur, and without compression artifacts.

  • The image should match the property's name and description.

  • Images with borders, blank edges, non-transparent logos, and other elements that hinder viewing the content are not allowed.

About the feed for a gallery of selections and individual ads

A set should contain at least three offers with URLs that differ from the set's URL. An offer should contain the name, url, and picture parameters. Offers in a set shouldn't contain identical images.

For rental offers, set the param name="Тип предложения" parameter to "Аренда". For rentals with daily rates, set the param name="Посуточно" parameter to "true". For a gallery of selections, add the param name="Число объявлений" parameter.

About the feed for a residential complex

In this type of feed, a set is a specific residential complex, and offers are selections of apartments in it. Offers (table rows) should contain information about the number of rooms, minimum area, price, and number of offers on the site.

The feed should contain an offer whose URL is the same as the set's URL, with at least four images and the development's coordinates. That offer shouldn't be linked to the table set (the set with the URL of the residential complex).

Example of using sets

<shop>
<sets>
<set id="s1">
<name>Residential complex "Gorky Park" — official information, apartment prices</name>
<url>https://realty.yandex.ru/voronezh/kupit/novostrojka/park-gorkogo-884707/</url>
</set>
<set id="s2">
<name>Buy an apartment in a new build in Voronezh</name>
<url>https://realty.yandex.ru/voronezh/kupit/novostrojka/</url>
</set>
</sets>
<offers>
<offer id="zk-884707"><!--Offer set-->
<name>Residential complex "Gorky Park" — official information, apartment prices</name>
<url>https://realty.yandex.ru/voronezh/kupit/novostrojka/park-gorkogo-884707/</url>
<categoryId>101</categoryId>
<price from="true">2800000</price>
<currencyId>RUR</currencyId>
<param name="Conversion">1.0</param>
<param name="Offer type">Sale</param>
<set-ids>s2</set-ids><!--Announced set, which the offer URL does not match-->
<param name="Number of listings">3</param>
<param name="Latitude">51.‪6954002380‬3711</param>
<param name="Longitude">39.‪2319679260‬2539</param>
<description>Prices, layouts, and availability of apartments. Current offers in the residential complex "Gorky Park". Voronezh, Maksim Gorky embankment, 49B</description>   
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a‪0000016581‬cb5ce4a0395c86b9ad6ecbb5/large</picture>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a00000160a010e6ff0d‪0459839799‬ffd061/large</picture>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a00000160a4bbe8c88590d603308d9330ea/large</picture>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a‪0000016094‬c359841a069c1c38c57bc0f2/large</picture>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a00000160a2ef63a2aa8af5c98f83da8449/large</picture>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a‪0000016093‬9d08752154ac874877ff48a7/large</picture>
</offer>
<offer id="table-row-1-884707"><!--Offer table row-->
<name>1-room</name>
<url>https://realty.yandex.ru/voronezh/kupit/kvartira/odnokomnatnaya/zhk-park-gorkogo-884707/</url>
<categoryId>11</categoryId>
<price from="true">2800000</price>
<currencyId>RUR</currencyId>
<param name="Conversion">1.0</param>
<param name="Offer type">Sale</param>
<set-ids>s1</set-ids>
<param name="Area">24</param>
<param name="Number of listings">2</param>
<param name="Number of rooms">1</param>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a000001609c38220ae58226ff3a5bfa2da9/large</picture>
</offer>
<offer id="table-row-3-884707"><!--Offer table row-->
<name>3-room</name>
<url>https://realty.yandex.ru/voronezh/kupit/kvartira/tryohkomnatnaya/zhk-park-gorkogo-884707/</url>
<categoryId>13</categoryId>
<price from="true">5600000</price>
<currencyId>RUR</currencyId>
<param name="Conversion">1.0</param>
<param name="Offer type">Sale</param>
<set-ids>s1</set-ids>
<param name="Area">77</param>
<param name="Number of listings">1</param>
<param name="Number of rooms">3</param>
<picture>https://avatars.mds.yandex.net/get-realty/174962/offer.2a000001609c38220ae58226ff3a5bfa2da9/large</picture>
</offer> 
</offers>
</shop>
Example of a list of categories

If a category doesn't have any offers in a particular file, you don't need to include it in this file.

<categories>
<category id="1">Apartment</category>
<category id="2">Room</category>
<category id="3">House</category>
<category id="4">Land plot</category>
<category id="5">Parking space</category>
<category id="6">Commercial space</category>
<category id="10" parentId="1">Studio</category>
<category id="11" parentId="1">1-room</category>
<category id="12" parentId="1">2-room</category>
<category id="13" parentId="1">3-room</category>
<category id="14" parentId="1">4+ rooms</category>
<category id="15" parentId="1">Open plan</category>
<category id="21" parentId="3">Part of a house</category>
<category id="22" parentId="3">Townhouse</category>
<category id="23" parentId="3">Duplex</category>
<category id="31" parentId="5">Garage</category>
<category id="32" parentId="5">Box</category>
<category id="33" parentId="5">Parking space</category>
<category id="41" parentId="6">Office</category>
<category id="42" parentId="6">Retail space</category>
<category id="43" parentId="6">Space with free purpose</category>
<category id="44" parentId="6">Warehouse</category>
<category id="45" parentId="6">Production space</category>
<category id="46" parentId="6">Commercial land plot</category>
<category id="47" parentId="6">Food service</category>
<category id="48" parentId="6">Car service</category>
<category id="49" parentId="6">Hotel</category>
<category id="50" parentId="6">Ready business</category>
<category id="51" parentId="6">Legal address</category>
<category id="101">Residential complex</category>
<category id="102">Cottage settlement</category>
</categories>

Learn more about working with the feed

How to send a feed

You can upload your feed:

Log in to Yandex. Add the site to Yandex Webmaster and verify your management rights, or get access for your account from the site owner.

  1. Go to the Services and offers in search → Feeds and errors page in Yandex Webmaster.

  2. Click Upload feed.

  3. Select the Realty business category if you're submitting information about selling apartments, offices, houses, and other buildings.

  4. Specify the region. For example, if offers in the feed are available on the same terms in all regions, select Russia.

  5. In the Link to file with offers field, enter the URL that looks like https://example.com/feed.yml.

    If your site has authorization configured to access the YML file, you can send the username and password along with the URL which it's available at. For example: http://yandex:WE9h4FfBml@example.com/feed.yml.

  6. Click Done.

For more information, see documentation.

Yandex Webmaster will check the feed. If it contains errors, a message about errors will appear in Yandex Webmaster on the Services and offers in search → Feeds and errors page. To learn more, click Errors next to the feed. Fix the errors, and Yandex Webmaster will check the feed again after a certain amount of time.

Also, the site and offers information will be checked by the quality control service within a few days. The feed can be rejected for violations of the rules.

Terms

The site must ensure that the data is correct and the offers match the subject. It is also responsible for dissemination of illegal information. In the event the terms are violated, Yandex has the right not to use the site data for changing the display in the search results.

The feed data can be used to enrich the organic search result representing your service in search if this increases the surplus (the usefulness metric) of the search output.

Such enrichment is provided only for pages of a suitable format that contain a list of objects.

The response position in the search results is determined by the general ranking principles: the pages that are most relevant to the query get higher positions. The order of the cards within the response is determined using research into user interaction with the cards to maximize conversion and surplus.

We strive to show information in search results that will be useful to a particular user. To take into account conversion data for ranking offers within the responses described on this page, we recommend installing Yandex Metrica on your service. This will make search results personalization more efficient.

Learn more about events in Yandex Metrica.

Page updated: June 15, 2022.

Change history
  • Added a reference to the response display example in “What it adds to search results”.
  • Added a screenshot illustrating the difference between a set and an offer.
Subscribe to updates

Contact support

Choose a category:

Fill out the form below if the data relates to the following categories: Education, Performers, Realty, Vehicles, Vacancies, Doctors.

The team will try to take your opinion into account in the future updates.




You can also go to




You can also go to

Previous
Music
Next
Site quality control