Service providers

Applicable sites

Information sites where handymen, tutors, and other on-demand service providers can list their offers.

What is added to the search results

Offers from service providers. Each offer includes the price, person's rating, and number of reviews. Such answers help the user to see the most important information about the specialists matching their query, compare them, and choose the one that suits them best.

Who is displayed in the list depends on the location, prices, reviews, and other factors.

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 requirements

The feed contains offers with information about specific services of a specific service provider. For example, a set like "Construction and repairs in Moscow" can contain offers "Bestmaster" and "Sole proprietor Ivanov".

Feed example

Offer elements

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

Element	Note
name *	The name of the service provider: individual, organization, or sole proprietor.
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 cost.
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 *	A link to the service provider's logo or photo. Offers can't have duplicate links, but you can upload identical photos with different links.
description *	The service name, the service provider's profession, and so on.
param name="Рейтинг" (Rating) *	Number. For a new service provider, or when there is no rating, enter 0.
param name="Число отзывов" (Number of reviews) *	Number.
param name="Годы опыта" (Years of experience) *	Number.
param name="Регион" (Region) *	String. You can specify the country, region, city, city district, and metro station.
param name="Конверсия" (Conversion) *	Number. An arbitrary value. The higher it is, the better the offer.
param name="Ссылка на телефон" (Link to phone number)	String.
param name="Ссылка на чат" (Link to chat)	String.
param name="Ссылка на создание заказа" (Link to order creation page)	String. If this link isn't identical to the offer URL.
param name="Ссылка на профиль исполнителя" (Link to the service provider's profile)	String.
sales_notes	Notes. Examples: "Цена договорная" (price is negotiable), "Цена за метр" (price per meter).
expiry	The warranty period. See The element list and descriptions to learn more.
param name="Исполнитель проверен" (Verified service provider)	true or false (by default).
param name="Организация" (Organization)	true or false (by default).
param name="Выполняется удаленно" (Work done remotely)	true or false (by default).
param name="Выполняется по адресу исполнителя" (Work done at the service provider's address)	true or false (by default).
param name="Выполняется по адресу заказчика" (Work done at the customer's address)	true or false (by default).
param name="Бригада" (Team)	true or false (by default).
param name="Об исполнителе" (About service provider)	String.
param name="Отзыв на исполнителя - X" (Review about the service provider)	String. "X" is the review number (from 1 to 5). You can use the unit attribute to specify the review rating, for example, unit="4.9".
param name="Другая услуга исполнителя - X" (Additional service)	String. "X" is the service number (from 1 to 5).

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.

About the feed

Names of service providers (value of the name parameter) shouldn't occur more than once in the same set.

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">Performer</category>
<category id="11" parentId="1">Repair and construction</category>
<category id="12" parentId="1">Repair and installation of equipment</category>
<category id="13" parentId="1">Car repair</category>
<category id="14" parentId="1">Tutors and education</category>
<category id="15" parentId="1">Beauty</category>
<category id="16" parentId="1">Transportation and couriers</category>
<category id="17" parentId="1">Housekeeping and cleaning</category>
<category id="18" parentId="1">Computers and IT</category>
<category id="19" parentId="1">Designers</category>
<category id="20" parentId="1">Rental</category>
<category id="21" parentId="1">Lawyers</category>
<category id="22" parentId="1">Trainers</category>
<category id="23" parentId="1">Photo, video, audio</category>
<category id="24" parentId="1">Creativity, needlework and hobbies</category>
<category id="25" parentId="1">Event organization</category>
<category id="26" parentId="1">Artists</category>
<category id="27" parentId="1">Security and detectives</category>
<category id="28" parentId="1">Services for animals</category>
<category id="29" parentId="1">Miscellaneous</category>
<category id="101" parentId="11">Apartment and house repair</category>
<category id="102" parentId="11">Windows and balconies</category>
<category id="103" parentId="11">Construction of baths, saunas and pools</category>
<category id="104" parentId="11">Plumbing and heating</category>
<category id="105" parentId="11">Electrical installation works</category>
<category id="106" parentId="11">Finishing of wooden houses, baths, saunas</category>
<category id="111" parentId="12">Mobile phones and tablets</category>
<category id="112" parentId="12">Air conditioners</category>
<category id="113" parentId="12">Refrigerators</category>
<category id="114" parentId="12">Washing machines</category>
<category id="115" parentId="12">Dishwashers</category>
<category id="116" parentId="12">Kitchen stoves</category>
</categories>

Learn more about working with the feed

How to send a feed

You can upload your feed:

In Yandex Webmaster

By using Yandex Webmaster API

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 Performers business category if you're submitting information about service provider's rendering household and other services. For example, furniture transportation.

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: May 31, 2023.