Vehicles

Eligible sites

Sites selling cars, commercial vehicles, motorcycles, and other motor vehicles.

What it adds to search results

Cards with vehicle offers that match the user's query and provide well structured, precise, and helpful information about the ads. Clicking a card opens the partner site where the user can see all the relevant ads. For more narrow queries (for example, mentioning a particular model), the answer may contain details about trim levels, option packages, and prices.

Display example (design may change)

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 car or motorcycle.
• A selection. For example, "Toyotas in Moscow" or "BMW E-segment cars". 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 a Toyota in Moscow" contains a "Camry" offer.
• The set "Buy a Toyota Camry in Moscow" (with the same URL as the "Camry" offer) contains the offer "2017, 52,771 km".

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.
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 vehicle or of the car dealer. 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.
vendor	The manufacturer name. For a dealer, specify names separated by commas.
description	Description.
param name="Число объявлений" (Number of ads)	Number. The presence of this field means that the offer is a selection.
param name="Число объявлений во всех регионах" (Number of ads in all regions)	Number.
param name="Число отзывов" (Number of reviews)	Number.
param name="Ссылка на отзывы" (Link to reviews)	String.
param name="Ссылка на характеристики" (Link to characteristics)	String.
param name="Ссылка на комплектации" (Link to trim levels)	String.
param name="Опубликовано" (Posted)	Date in ISO 8601 format.
param name="Размещено дилером" (Posted by a dealer)	true or false (by default).
param name="Год создания" (Year of manufacture)	Number.
param name="Годы создания" (Years of manufacture)	Two numbers separated by a hyphen (for example, 2020-2021). Used for selections.
param name="Пробег" (Mileage)	Number. In kilometers. If the vehicle is new, enter 0.
param name="Комплектация" (Trim level)	String. For example, 318i Sport Line Edition 21.
param name="Двигатель, литры" (Engine, liters)	Number.
param name="Двигатель, л.с." (Engine, hp)	Number.
param name="Двигатель, тип" (Engine, type)	"Атмосферный" (naturally aspirated) "Турбированный" (turbocharged)
param name="Топливо" (Fuel)	"Бензин" (gasoline) "Дизель" (diesel) "Гибрид" (hybrid) "Электро" (electrical energy) "Водород" (hydrogen) "Пропан" (propane)
param name="Коробка передач" (Transmission)	"Автомат" (AT) "Автоматическая" (automatic) "Механика" (MT) "Механическая" (manual) Robot "Вариатор" (CVT)
param name="Привод" (Drive)	"Передний" (front-wheel) "Задний" (rear-wheel) "Полный" (four-wheel)
param name="Состояние" (Condition)	"Не требует ремонта" (no repair need) "Нуждается в ремонте" (in need of repair) "Не на ходу" (non-runner)
param name="Повреждения" (Damage)	String.
param name="Адрес" (Address)	String. For dealers.
param name="Широта" (Latitude)	Number. For dealers.
param name="Долгота" (Longitude)	Number. For dealers.

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 feeds for a selection of specific ads or models

For a selection of specific ads or models to be generated, the set must contain at least four offers. Each offer must have at least one image, and this image shouldn't be featured in other offers. The URL of the set shouldn't be identical to offer URLs. For a selection of models, specify the parameter param name="Число объявлений". For a selection of ads, this parameter should be omitted.

About feeds for a selection of trim levels

For a selection of trim levels to be generated, the feed must contain an offer whose URL matches the URL of the set (but not included in it), and the offer should have at least four images. The URLs of other offers (table rows) shouldn't be identical to the URL of the set, and the offers should contain these parameters: param name="Двигатель, литры" , param name="Коробка передач", param name="Двигатель, л.с.".

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">Car dealer</category>
<category id="2" parentId="1">Official car dealer</category>
<category id="3">Motor vehicles</category>
<category id="11" parentId="3">Passenger сar</category>
<category id="12" parentId="3">Commercial vehicles</category>
<category id="13" parentId="3">Motor transport</category>
<category id="101" parentId="11">SUV</category>
<category id="102" parentId="11">Sedan</category>
<category id="103" parentId="11">Hatchback</category>
<category id="104" parentId="11">Liftback</category>
<category id="105" parentId="11">Station wagon</category>
<category id="106" parentId="11">Minivan</category>
<category id="107" parentId="11">Coupe</category>
<category id="108" parentId="11">Pickup</category>
<category id="109" parentId="11">Convertible</category>
<category id="110" parentId="11">Van</category>
<category id="121" parentId="12">Light commercial</category>
<category id="122" parentId="12">Trucks</category>
<category id="123" parentId="12">Semi-tractors</category>
<category id="124" parentId="12">Buses</category>
<category id="125" parentId="12">Trailers and semi-trailers</category>
<category id="126" parentId="12">Agricultural</category>
<category id="127" parentId="12">Construction and road</category>
<category id="128" parentId="12">Loaders</category>
<category id="129" parentId="12">Cranes</category>
<category id="130" parentId="12">Excavators</category>
<category id="131" parentId="12">Bulldozers</category>
<category id="132" parentId="12">Utility</category>
<category id="141" parentId="13">Motorcycles</category>
<category id="142" parentId="13">Scooters</category>
<category id="143" parentId="13">ATVs</category>
<category id="144" parentId="13">Snowmobiles</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 Vehicles business category if the information is related to selling cars, motorcycles, and other means of 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: June 15, 2022.