Doctors
Eligible sites
Sites with information about doctors and medical services.
What it adds to search results
An answer with doctor cards from specialized sites. Each card contains basic information about the doctor: the consultation fee, experience, and number of patient reviews. In addition, users can view the doctor's schedule and go to the site to make an appointment.
Such an answer helps users to see the most important information about the relevant specialists, compare them, and choose the most suitable doctor. Who is displayed in the list depends on the doctors' qualifications, location, prices, reviews, and other factors.
How to set it up
To include your offers in such responses, send information about them to Yandex. First, prepare a YML feed or a file in XLSX format.
A response with information from the offers is generated in the search results.
Offers can also be automatically included in the response based on the processing of data from the Yandex search robot.
A doctor can edit their card using their Yandex ID profile. To do this, the doctor has to add information to their profile and verify their account. See Doctor cards in Yandex Search to learn more.
A feed in YML format
The YML standard was developed by Yandex and is based on the XML standard. A feed is a file that you use to provide information about your services and offers. It describes the offers
combined into sets
and categories
, to which the offer refers.
Feed requirements
Your feed must contain offers with information about specific services of a specific doctor.
Alert
Before you upload a feed with a doctor's details, make sure that you've received the doctor's consent for sharing and using their details in all the relevant cases.
The feed must comply with the terms of placement.
There must be a separate offer
for each service provided by the doctor. For example, if the doctor gives initial consultations in three clinics, add three offers. Group the offers that are related to the same doctor using the group_id
attribute.
Only offers with the same group_id
can have identical URLs. All offers with identical URLs must be in the same file.
Only one category can be specified in the categories element: Doctor.
In the offers that are related to the same doctor, the following must be identical:
- List of specialties.
- Full name.
- Years of experience.
- Description.
- Link to the doctor's photo.
Information about the reviews, education, and career must be included in one of the doctor's offers. If this requirement isn't met, the algorithms may pick and display just a single set of details.
Review contents and ratings must match what users can see on the site. For a review to be displayed in the card, it's enough to provide a rating and one of these text fields: Liked
, Disliked
, or Comment
.
We recommend that you include all the reviews about the doctor on a given site (in a given clinic) in your feed, because the number of reviews displayed in the card is counted according to the number of reviews in the feed.
Feed restrictions
YML file size |
200 MB |
Total number of images |
50,000 |
Number of images in one |
200 |
Number of |
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 |
1 million |
Total number of all YML files (service and offer feeds, RSS feeds for Turbo pages with content) for the site and its subdomains |
1000 |
Doctors' specialties
To pass information about doctors' specialties, use the sets
element in the shop
element.
In the name
attribute, enter the doctor's specialty in Russian, using the singular form. Example: Терапевт
(general practitioner). You can list specialties and subspecialties together. Example: Стоматолог
, стоматолог-гигиенист
(dentist, dental hygienist). Enter the doctor's specialty, not the field, that is, Хирург
(surgeon) rather than "хирургия" (surgery).
Don't list academic degrees, ranks, professional categories, job positions, or the consultation type (for adults, for children, and so on) in name
.
The id
attribute value can contain Latin letters and digits.
The id
and name
attributes are required. One set
can have only one name
attribute.
Example:
...
<shop>
<sets>
<set id="terapevt">
<name>General practitioner</name>
<url>https://doctors.sample.s3.yandex.net/terapevt</url>
</set>
<set id="khirurg">
<name>Surgeon</name>
<url>https://doctors.sample.s3.yandex.net/khirurg</url>
</set>
<set id="dantist">
<name>Dentist, dental hygienist</name>
<url>https://doctors.sample.s3.yandex.net/dantist</url>
</set>
<set id="dantist-sanitarian">
<name>Dental hygienist</name>
<url>https://doctors.sample.s3.yandex.net/dantist-sanitarian</url>
</set>
</sets>
<offers>
<offer id="A1">
...
<set-ids>terapevt,khirurg,dantist,dantist-sanitarian</set-ids>
</offer>
<offer id="D2">
...
<set-ids>terapevt</set-ids>
</offer>
</offers>
</shop>
...
Offer elements
Minimum set of offer elements; the required ones are marked with an asterisk:
Note
Don't pass empty fields. If a field is optional and there is no value, omit the field.
Site description elements (shop) |
|
|
A short and clear site name for display in the card. Up to 30 characters. |
|
Organization name. |
|
The site URL. |
|
The contact email address. |
|
The site logo. Requirements:
If the logo is on a white background, fill the image area with the logo as much as possible. It helps increase the site brand awareness. |
|
Specialties defined by a name and a URL. To provide the doctor's specialties, use the set-ids element within the |
Offer elements |
|
|
The doctor's full name. Make sure to enter it in this order: |
|
The URL of the doctor's page on your site. Must be unique for each offer. If it's impossible to give an offer a unique URL (for example, the doctor's page exists on the site, but there are no separate URLs for different consultation types), add a non-significant parameter to the URL: |
|
The consultation fee when booking an appointment (discount included). With the For the fee to be displayed in the doctor card, set |
|
The consultation fee at the clinic (without the discount if the |
|
The currency. Use a three-letter currency code in ISO 4217 format. |
|
The service. Possible values:
|
|
A list of the doctor's specialties, with values separated by commas. |
|
A link to the doctor's photo. Recommendations:
Optional. |
|
A text description of the doctor's specialty (will be shown in the card). Try to provide a detailed description worded in a way that is easy for users to understand. |
|
Category ID. |
|
The doctor's last name. |
|
The doctor's first name. |
|
The doctor's patronymic, if any. |
|
Whole number. |
|
The career start date in ISO 8601 format. |
|
The city where the doctor gives consultations. |
|
Consultations for adults (over 18 years old). Possible values: |
|
Consultations for children (under 18 years old). Possible values: |
|
The total number of reviews that can be read at this doctor's URL. Default value — 0. Optional. |
|
"Кандидат наук" (Candidate of Sciences) or "Доктор наук" (Doctor of Sciences). |
|
"Профессор" (professor) or "Доцент" (docent). |
|
"Первая категория", "Вторая категория", or "Высшая категория" (first, second, or superior grade). |
|
Ranks, titles, and distinctions that don't belong in |
Description of the "doctor — clinic" link |
|
|
The city where the clinic is. |
|
The address of the clinic. As specified in the clinic's card in Yandex Business. |
|
The clinic name. As specified in the clinic's card in Yandex Business. |
|
Organization ID in Yandex Search. Possible values: integer. For example, If the ID wasn't detected automatically, you can use the ID from Yandex Maps:
For example, for the link |
|
Whether an appointment can be booked through the site providing the feed. Possible values: |
|
Possible values: |
|
The phone number for making appointments. It can be a substitute number if your site uses number substitution. |
|
A text field. The ID that is used in your system. For example, Required for generating a search result with doctor schedules. Pass one or more parameters. |
|
|
|
|
|
Whether an appointment can be made using the OMS (compulsory health insurance) policy. Possible values: |
|
Whether house calls can be made. Possible values: |
|
The availability of video consultations (telemedicine). Possible values: |
The doctor's education, jobs, and certificates |
|
|
|
|
The name of the educational institution. For example, Astrakhan State Medical University. |
|
The year of graduation in this field of study. For example, 2006. |
|
The education level: "Базовое" (entry-level), "Ординатура" (residency), and so on. |
|
Specialty. |
|
The name of the organization that the doctor worked at. |
|
Time of employment at this organization. For example, |
|
The job title and specialization. For example, |
|
The name of the organization that issued the certificate. |
|
Certificate issue date. |
|
Certificate name. |
Reviews |
|
|
|
|
The reviewer's name. |
|
String. Required for distinguishing between reviewers with identical names. |
|
String. The URL of an image. |
|
The review date in ISO 8601 format. |
|
Whether the appointment with the doctor was verified and the review passed moderation. Possible values: |
|
Whether the review is included in the average rating for displaying the doctor card. Possible values: |
|
The user rating, from 1 to 5. |
|
The description of what the reviewer liked (if included in the review). |
|
The description of what the reviewer didn't like (if included in the review). |
|
The user's comment, or the review body if there is only one text field in the review form. |
|
The response to the review. |
|
Review URL. For example, |
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.
Online schedule
An answer can contain information about the doctor's schedule with appointment functionality. After selecting a date and time, the user will go to your site to book an appointment.
To connect, contact support at partner-wizards@yandex-team.ru. Put “Integration of online doctor appointment schedule: cooperation proposal from
For technical requirements, see the Sending Data on Doctor Schedules section of the Yandex Webmaster API Help section.
Since April 1, 2025, when submitting doctor schedule data, you must also provide information on all user appointments made for a specific time slot. An appointment is counted when the user clicks the Make an appointment button on the partner's form, regardless of whether the appointment was confirmed or if the user visited the medical facility. Appointment information is submitted using API integration. For more information, see Confirming appointments.
Starting September 1, 2025, a paid contract will be required for submitting data about doctors’ schedules. Leave your contact details, and our manager will send you a contract template. If you choose not to enter into the contract, you can continue to submit data without doctors’ schedules.
Example of a list of categories
<categories>
<category id="1">Doctor</category>
</categories>
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.
-
Go to the Services and offers in search → Feeds and errors page in Yandex Webmaster.
-
Select the Doctors business category if you're providing information about doctors' services. For example, an appointment with a pediatrician.
-
Specify the region. For example, if offers in the feed are available on the same terms in all regions, select Russia.
-
Select YML and upload the feed.
-
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
. -
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.
A file in XLSX format
In the XLSX file, you can describe offers on the Врачи (Doctors) sheet. They're combined into sets, which are listed on the Специальности (Specialties) sheet.
Note
Download the XLSX template and fill it out following the instructions on the first sheet.
For each service provided by the doctor, there must be a separate offer (a row on the Врачи sheet). For example, if the doctor gives initial consultations in three clinics, add three offers. Give the same doctor ID to the offers that are related to the same doctor.
Only offers with the same value of Идентификатор врача
(Doctor ID) on the Врачи sheet can have identical URLs. All offers with identical URLs must be in the same file.
XLSX file restrictions
XLSX file size |
5 MB |
Total number of images |
50,000 |
Number of images for one doctor |
200 |
Number of doctors — rows on the Врачи sheet. |
30,000. Data from a file containing more offers won't be used for enhanced appearance. The file itself will be uploaded with an error. For the offers to appear in search results, split the file into several parts. Don't include offers with the same URL in multiple files, and don't move offers from one file to another: the data from the moved offer may temporarily disappear from search results. |
Number of specialties — rows on the Специальности sheet. |
1 million |
Doctors' specialties
To pass information about doctors' specialties, use the Специальности sheet.
In the Название специальности (Specialty name) column, enter the doctor's specialty in Russian, using the singular form. Example: Терапевт
(general practitioner). You can list specialties and subspecialties together. Example: Стоматолог
, стоматолог-гигиенист
(dentist, dental hygienist). Enter the doctor's specialty, not the field, that is, Хирург
(surgeon) rather than "хирургия" (surgery).
Don't enter academic degrees, ranks, professional categories, job positions, or the consultation type (for adults, for children, and so on) in the specialty name.
The specialty name is required, while a link to the specialty is optional.
Offer elements
Minimum set of offer elements; the required ones are marked with an asterisk:
Note
Don't pass empty fields. If a field is optional and there is no value, omit the field.
Rows of the "Данные клиники (Clinic details)" sheet |
|
|
A short and clear site name for display in the card. Up to 30 characters. |
|
Organization name. |
|
The site URL. |
|
The contact email address. |
|
The site logo. Requirements:
If the logo is on a white background, fill the image area with the logo as much as possible. It helps increase the site brand awareness. |
Columns of the "Врачи (Doctors)" sheet |
|
|
The doctor's full name. Make sure to enter it in this order: |
|
A unique ID that can be used to identify the doctor in the system (an arbitrary value). If multiple offers are associated with the doctor, enter the same doctor ID for them. |
|
The URL of the doctor's page on your site. Must be unique for each offer. If it's impossible to give an offer a unique URL (for example, the doctor's page exists on the site, but there are no separate URLs for different consultation types), add a non-significant parameter to the URL: |
|
The consultation fee when booking an appointment through the feed's source (discounts included). The parameter To display the fee on the doctor card, set parameter |
|
Enter |
|
The appointment fee at the clinic (without the discount if the |
|
The service. Possible values:
|
|
A list of the doctor's specialties, with values separated by commas. |
|
A link to the doctor's photo. Recommendations:
Optional. |
|
A text description of the doctor's specialty (will be shown in the card). Try to provide a detailed description worded in a way that is easy for users to understand. |
|
Whole number. |
|
The career start date in ISO 8601 format. |
|
The city where the doctor gives consultations. |
|
Consultations for adults (over 18 years old). Possible values: |
|
Consultations for children (under 18 years old). Possible values: |
|
The total number of reviews that can be read at this doctor's URL. Default value — 0. |
|
"Кандидат наук" (Candidate of Sciences) or "Доктор наук" (Doctor of Sciences). |
|
"Профессор" (professor) or "Доцент" (docent). |
|
"Первая категория", "Вторая категория", or "Высшая категория" (first, second, or superior grade). |
|
The city where the clinic is. |
|
The address of the clinic. As specified in the clinic's card in Yandex Business. |
|
The clinic name. As specified in the clinic's card in Yandex Business. |
|
Whether an appointment can be booked through the site providing the file. Possible values: |
|
Possible values: |
|
The phone number for making appointments. It can be a substitute number if your site uses number substitution. |
|
If the ID wasn't detected automatically, you can use the ID from Yandex Maps:
For example, for the link |
|
The ID that is used in your system. For example, "id123". Required for generating a search result with doctor schedules. Pass one or more parameters. |
|
|
|
|
|
Whether an appointment can be made using the OMS (compulsory health insurance) policy. Possible values: |
|
Whether house calls can be made. Possible values: "ИСТИНА" (TRUE) or "ЛОЖЬ" (FALSE, default). |
|
The availability of video consultations (telemedicine). Possible values: |
Columns of the "Доп информация врача (More doctor details)" sheet |
|
|
A doctor whose information is fully specified on the Врачи sheet. |
|
The type of the doctor's activities during the specified period. Possible values:
|
|
The name of the institution. For example, Astrakhan State Medical University. |
|
The start year of the activity period. |
|
The end year of the activity period. Optional. |
|
The job title and specialization. For example, |
"Отзывы о враче (Doctor reviews)" sheet |
|
|
A doctor whose information is fully specified on the Врачи sheet. |
|
The reviewer's name. |
|
Required for distinguishing between reviewers with identical names. |
|
The URL of an image. |
|
The review date in ISO 8601 format. |
|
Whether the appointment with the doctor was verified and the review passed moderation. Possible values: |
|
Whether the review is included in the average rating for displaying the doctor card. Possible values: |
|
The user rating, from 1 to 5. |
|
The description of what the reviewer liked (if included in the review). |
|
The description of what the reviewer didn't like (if included in the review). |
|
The user's comment, or the review body if there is only one text field in the review form. |
|
The response to the review. |
|
Review URL. For example, |
Online schedule
An answer can contain information about the doctor's schedule with appointment functionality. After selecting a date and time, the user will go to your site to book an appointment.
Example (the design may vary)
To connect, contact support at partner-wizards@yandex-team.ru. Put “Integration of online doctor appointment schedule: cooperation proposal from
For technical requirements, see the Sending Data on Doctor Schedules section of the Yandex Webmaster API Help section.
Since April 1, 2025, when submitting doctor schedule data, you must also provide information on all user appointments made for a specific time slot. An appointment is counted when the user clicks the Make an appointment button on the partner's form, regardless of whether the appointment was confirmed or if the user visited the medical facility. Appointment information is submitted using API integration. For more information, see Confirming appointments.
Starting September 1, 2025, a paid contract will be required for submitting data about doctors’ schedules. Leave your contact details, and our manager will send you a contract template. If you choose not to enter into the contract, you can continue to submit data without doctors’ schedules.
How to upload an XLSX file
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.
-
In Yandex Webmaster, go to Services and offers in search results → Feeds and errors.
-
Click Upload feed.
-
Choose the Doctors business category.
-
Specify the region. For example, if the offers in the file are available on the same terms in all Russian regions, select Russia.
-
Select XLSX file and upload the file.
-
Click Done.
Yandex Webmaster will check the XLSX file. If it contains errors, a message about errors will appear next to the file on the Services and offers in search results → Feeds and errors page in Yandex Webmaster. To learn more, click Errors next to the feed. Fix the errors, and Yandex Webmaster will check the file again shortly after.
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 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: July 21, 2025.
Change history
- Changed the date from which a paid contract is required to provide doctor schedule data.
Subscribe to updates
Element
Set IDs. You can list several sets separated by commas, for example: s1,s2,s3
.