Vacancies

Eligible sites

Sites that specialize in posting job ads.

What it adds to search results

A list of industries or specific job ads from specialized sites. The user can quickly read the job ads matching their query. The answer takes into account the region, popularity, 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

A feed can contain different offer types:

• A specific offer. For example, a particular vacancy in a specific company with a specific salary.
• A selection. For example, "Vacancies of the day" or "Lawyer vacancies at Sberbank". Details: the minimum salary, 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 "Vacancies at Sberbank" contains a "Lawyers" offer.
• The set "Lawyer vacancies at Sberbank" (with the same URL as the "Lawyers" offer) contains an "In-house counsel in retail" offer.

Feed example

Offer elements

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

Element	Note
name *	The name of the offer.
vendor *	The employer's name.
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 *	The salary. A value from 1000 to 1,000,000. 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 *	The employer's logo. 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.
sales_notes	Notes. For example, whether it's a daily, monthly, or annual salary.
description	Description.
param name="Тип зарплаты" (Salary type)	нет (none) or гросс (gross, default).
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="Сайт работодателя" (Employer's site)	String.
param name="Телефон работодателя" (Employer's phone number)	String.
param name="Регион" (Region)	String. You can specify the country region, city, city district, and metro station.
param name="Адрес" (Address)	String.
param name="Широта" (Latitude)	Number.
param name="Долгота" (Longitude)	Number.
param name="Опубликовано" (Posted)	Date in ISO 8601 format.
param name="График работы" (Work schedule)	"Полный день" (full-time) "Гибкий график" (flexible) "Сменный график" (shift work) "Вахтовый метод" (rotation-based) "Удаленная работа" (remote work)
param name="График смен" (Shift schedule)	String. For example, "2/2".
param name="Тип занятости" (Employment type)	"Полная" (full-time) "Частичная" (part-time) "Стажировка" (internship) "Проектная" (project-based) "Волонтерство" (voluntary work)
param name="Опыт работы" (Experience)	Number. The minimum experience of the candidate, in years.
param name="Размещено кадровым агентством" (Posted by a recruiting agency)	true or false (by default).
param name="Зарплата до" (Salary up to)	Number.

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

A set should contain at least three offers with differing URLs. For a list of job ads from different companies to be displayed, the set should contain offers with distinct ad titles and employer names. Each offer can include only one image.

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.

Вакансия (vacancy) and Работодатель (employer) are required categories.

<categories>
  <category id="1">Vacancy</category>
  <category id="2">Employer</category>
  <category id="10" parentId="1">Automotive business</category>
  <category id="11" parentId="1">Administrative staff</category>
  <category id="12" parentId="1">Banks, investments, leasing</category>
  <category id="13" parentId="1">Security</category>
  <category id="53" parentId="1">Without special training</category>
  <category id="14" parentId="1">Accounting, management accounting, enterprise finance</category>
  <category id="15" parentId="1">Top management</category>
  <category id="16" parentId="1">Public service</category>
  <category id="17" parentId="1">Hotel business</category>
  <category id="18" parentId="1">Home staff</category>
  <category id="19" parentId="1">Housing and communal services</category>
  <category id="20" parentId="1">Procurement</category>
  <category id="21" parentId="1">Publishing house, polygraphy</category>
  <category id="22" parentId="1">Installation and service</category>
  <category id="23" parentId="1">Information technologies</category>
  <category id="84" parentId="1">Internet, communications, telecom</category>
  <category id="24" parentId="1">Art, culture</category>
  <category id="25" parentId="1">Consulting</category>
  <category id="26" parentId="1">Marketing, advertising, PR</category>
  <category id="27" parentId="1">Mass media</category>
  <category id="28" parentId="1">Medicine, pharmacy</category>
  <category id="29" parentId="1">Science</category>
  <category id="30" parentId="1">Career start, students</category>
  <category id="31" parentId="1">Realty</category>
  <category id="32" parentId="1">Non-profit organizations</category>
  <category id="73" parentId="1">Education</category>
  <category id="33" parentId="1">Public catering</category>
  <category id="34" parentId="1">Sales</category>
  <category id="35" parentId="1">Manufacturing</category>
  <category id="36" parentId="1">Working staff</category>
  <category id="37" parentId="1">Entertainment</category>
  <category id="38" parentId="1">Beauty salons</category>
  <category id="39" parentId="1">Secretariat</category>
  <category id="40" parentId="1">Agriculture</category>
  <category id="41" parentId="1">Sports clubs, fitness</category>
  <category id="42" parentId="1">Insurance</category>
  <category id="43" parentId="1">Construction</category>
  <category id="93" parentId="1">Raw materials</category>
  <category id="44" parentId="1">Transport, logistics</category>
  <category id="45" parentId="1">Training</category>
  <category id="46" parentId="1">Tourism</category>
  <category id="47" parentId="1">Human resources</category>
  <category id="48" parentId="1">Lawyers</category>
  <category id="101" parentId="2">Commercial organizations with legal entity</category>
  <category id="102" parentId="2">Commercial organizations without legal entity</category>
  <category id="103" parentId="2">Non-profit organizations</category>
  <category id="111" parentId="101">Cooperatives</category>
  <category id="112" parentId="101">Limited liability companies</category>
  <category id="113" parentId="101">Public joint-stock companies</category>
  <category id="114" parentId="101">Private joint-stock companies</category>
  <category id="115" parentId="101">Unitary enterprises</category>
  <category id="116" parentId="101">Partnerships</category>
  <category id="121" parentId="102">Mutual funds</category>
  <category id="122" parentId="102">General partnerships</category>
  <category id="123" parentId="102">Branches and representative offices</category>
  <category id="124" parentId="102">Investment partnerships</category>
  <category id="125" parentId="102">Individual entrepreneurs</category>
  <category id="131" parentId="103">Consumer cooperatives</category>
  <category id="132" parentId="103">Public associations</category>
  <category id="133" parentId="103">Religious associations</category>
  <category id="134" parentId="103">Public funds and institutions</category>
  <category id="135" parentId="103">State corporations</category>
  <category id="136" parentId="103">Non-profit partnerships</category>
  <category id="137" parentId="103">Associations and unions</category>
  <category id="138" parentId="103">Cooperatives</category>
  <category id="151" parentId="115">Federal state enterprises</category>
  <category id="152" parentId="115">State enterprises of a Russian region</category>
  <category id="153" parentId="115">Municipal enterprises</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 Vacancies business category if you're submitting information about vacancies.

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.