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 in the following groups:
-
Information about
doctors. -
Information about
clinics. -
Information about
services. -
Information about
offers.
Example:
<shop version="2.0" date="2024-12-10 08:06">
<name>Яндекс.Здоровье</name>
<company>ООО Яндекс.Врачи</company>
<url>https://example.ru/</url>
<doctors>...</doctors>
<clinics>...</clinics>
<services>...</services>
<offers>...</offers>
</shop>
Example of a fully filled out feed.
Data sets about doctors, clinics, and services must include all elements that will be used in the offers listed in the YML file.
Example of using the "doctor" element
<doctor id="doctor_1">
<name>Иванов Иван Иванович</name>
<url>https://example.ru/doctors/2246852315/</url>
<description>Высококвалифицированный специалист - универсал со множеством специализаций!</description>
<internal_id>2246852315</internal_id>
<first_name>Иван</first_name>
<surname>Иванов</surname>
<patronymic>Иванович</patronymic>
<experience_years>9</experience_years>
<career_start_date>2015-01-01</career_start_date>
<degree>доктор медицинских наук</degree>
<rank>Профессор</rank>
<category>Первая</category>
<education>
<organization>Медицинский университет Реавиз</organization>
<finish_year>2010</finish_year>
<type>Специалитет</type>
<specialization>Лечебное дело (Лечебно-профилактическое дело)</specialization>
</education>
<job>
<organization>Яндекс.Врачи</organization>
<period_years>2010-н.в.</period_years>
<position>Терапевт</position>
</job>
<certificate>
<organization>Московский институт психоанализа</organization>
<finish_year>2020</finish_year>
<name>Лечебная физкультура и спортивная медицина</name>
</certificate>
<reviews_total_count>100</reviews_total_count>
<review>
<date>2024-12-07 09:00:24</date>
<checked>true</checked>
<used_in_rating>true</used_in_rating>
<author>Наталья</author>
<author_id>natalia123</author_id>
<author_picture>https://example.ru/reviews/natalia123.png</author_picture>
<url>https://example.ru/doctors/2246852315/reviews</url>
<comment>Долго ждать в регистратуре</comment>
<grade>4.5</grade>
<positive>Что-то, что понравилось</positive>
<negative>Что-то, что не понравилось</negative>
<response>Спасибо за отзыв!</response>
</review>
</doctor>
Example of using the "clinic" element
<clinic id="clinic_1">
<url>https://www.clinic.example.ru</url>
<picture>https://www.clinic.example.ru/logo.jpg</picture>
<name>Клиника Яндекс Здоровье</name>
<city>г. Москва</city>
<address>ул. Льва Толстого, 16</address>
<email>info@example.ru</email>
<phone>+79999999999</phone>
<internal_id>123</internal_id>
<company_id>1032739194</company_id>
</clinic>
Example of using the "service" element
<service id="service_1">
<name>Первичный приём</name>
<gov_id>A01.07.001</gov_id>
<description>Первичный приём стоматолога-хирурга, диагностика возможности и степени хирургического вмешательства</description>
<internal_id>123</internal_id>
</service>
Offers are generated based on the connection between the doctor, clinic, their specialty, and the provided service.
Specify a clinic, doctor’s specialty, and one service marked as basic for each offer.
Note
Indicate the initial appointment as the basic service, except for specialties where this isn't applicable (for example, a sonographer).
Example of using the "offer" element
<offer id="offer_1">
<url>https://example/doctors/2246852315/checkout/123</url>
<online_schedule>true</online_schedule>
<appointment>true</appointment>
<price>
<base_price>5200</base_price>
<currency>RUR</currency>
<discount name="Клубная карта">4000</discount>
<free_appointment>При условии дальнейшего лечения</free_appointment>
</price>
<service id="service_1"/>
<clinic id="clinic_1">
<doctor id="doctor_1">
<speciality>стоматолог-хирург</speciality>
<children_appointment>true</children_appointment>
<adult_appointment>true</adult_appointment>
<house_call>true</house_call>
<telemed>true</telemed>
<is_base_service>true</is_base_service>
</doctor>
</clinic>
</offer>
<offer id="offer_2">
<url>https://example/doctors/2246852315/checkout/124</url>
<oms>true</oms>
<online_schedule>true</online_schedule>
<appointment>true</appointment>
<service id="service_2"/>
<clinic id="clinic_1">
<doctor id="doctor_1">
<speciality>стоматолог-хирург</speciality>
<children_appointment>true</children_appointment>
<adult_appointment>true</adult_appointment>
<house_call>false</house_call>
<telemed>false</telemed>
<is_base_service>false</is_base_service>
</doctor>
</clinic>
</offer>
Alert
You may skip submitting information about additional services (besides the basic one). Currently, it isn't displayed in verticals but may be used in future experiments.
Feed element description
Note
Check that the feed includes the following information for each doctor, clinic, and doctor's specialty:
-
An offer that indicates the basic service.
Example
If doctor
Xworks at clinicYin two specialties (AandB), the feed must contain two offers:1.1 Doctor
X, clinicY, specialtyA, serviceInitial appointment.1.2 Doctor
X, clinicY, specialtyB, serviceInitial appointment. -
A link to the doctor’s profile or a link to the offer in the
offerelement.Example
This offer can't be used because the URL is specified neither for the doctor, nor for the
offerelement.... <doctor id="doctor-1"> <name>John Smith</name> <!-- The URL of the doctor's profile isn't specified --> </doctor> ... <offers> <offer id="offer-1"> <!-- The offer can't be used because it contains an error - the URL is specified neither for the doctor, not for the offer--> <!-- The URL of the doctor's profile isn't specified --> <service id="service-X"/> <clinic id="clinic-Y"> <doctor id="doctor-1"> ... </doctor> </clinic> </offer> </offers> ...
Required elements are marked with * in the table.
The "Number of elements" column indicates the allowed number of elements:
1: Only one element.
1-inf: At least one element.
0-1: One element at most.
0-inf: Any number.
|
Element |
Attribute |
Number of elements |
Data type |
Description |
|
|
1 |
Set of elements |
See an example of using the |
|
|
|
|
1 |
String |
Feed version. Specify |
|
|
|
1 |
String |
Feed creation date and time in ISO 8601 format. |
|
Elements of the |
||||
|
|
1 |
String |
Site name to be displayed in doctor cards. The maximum length is 30 characters. |
|
|
|
1 |
String |
Organization name. |
|
|
|
1 |
String |
URL of the site or clinic website. |
|
|
|
1 |
String |
Link to the site or clinic logo. Image requirements:
Logos on a white background must fill the image area as much as possible. It helps increase the site brand awareness. |
|
|
|
0-1 |
String |
The contact email address. |
|
|
|
1 |
Set of elements |
List of doctor descriptions. |
|
|
|
1 |
Set of elements |
List of clinic descriptions. |
|
|
|
1 |
Set of elements |
List of service descriptions. |
|
|
|
1 |
Set of elements |
List of descriptions of services provided by the doctor at the clinic. |
|
|
Elements of the |
||||
|
|
1-inf |
Set of elements |
Doctor description. See an example of using the |
|
|
Elements of the |
||||
|
|
|
1 |
String |
Unique doctor ID in the feed. |
|
|
1 |
String |
The doctor's full name. Order: |
|
|
|
0-1 |
String |
URL of the doctor's page on the site. A link to the doctor’s page will appear in search results under Contact info and links, in links to the information source, and in the list of links to appointment booking sites if the |
|
|
|
0-1 |
String |
Information about the doctor that couldn't be included in other fields. |
|
|
|
0-1 |
String |
Internal doctor ID in the clinic’s or site's information system. Specify if the online schedule is available. |
|
|
|
0-1 |
String |
The doctor's first name. Indicate, for example, if the doctor has a double name. |
|
|
|
0-1 |
String |
The doctor's last name. Indicate, for example, if the doctor has a double last name or the |
|
|
|
0-1 |
String |
Doctor's patronymic. Fill in if the doctor has no patronymic or it is complex. |
|
|
|
0-1 |
Integer |
Experience in full years. |
|
|
|
0-1 |
String |
Link to the doctor's photo. Image recommendations:
|
|
|
|
0-1 |
String |
Doctor's career start date in ISO 8601 format. If there is no exact date, specify January 1 of the career start year. |
|
|
|
0-1 |
String |
Doctor’s academic degree. Recommended values: PhD in Medicine, MD in Medicine, and others. |
|
|
|
0-1 |
String |
Doctor’s academic rank. Recommended values: Professor, Associate Professor, and others. |
|
|
|
0-1 |
String |
Doctor's category. Recommended values: highest, first, second. |
|
|
|
0-1 |
Integer |
Number of reviews about the doctor on the clinic website or on the site. |
|
|
|
0-inf |
Set of elements |
Doctor’s education and completed professional training courses. |
|
|
|
0-inf |
Set of elements |
Doctor's jobs. |
|
|
|
0-inf |
Set of elements |
Doctor's certificates. |
|
|
|
0-inf |
Set of elements |
Reviews about the doctor on the clinic website or on the site. |
|
|
Elements of the |
||||
|
|
0-1 |
String |
The educational institution where the doctor obtained a degree. For example, Astrakhan State Medical University. |
|
|
|
0-1 |
String |
Year of graduation. For example, 2006. |
|
|
|
0-1 |
String |
Education level: basic, residency, specialty program, and others. |
|
|
|
0-1 |
String |
Specialty. |
|
|
**Elements of the ** |
||||
|
|
0-1 |
String |
Organizations that the doctor worked at. |
|
|
|
0-1 |
String |
The period of employment with the organization. For example, |
|
|
|
0-1 |
String |
The job title and specialization. For example, |
|
|
Elements of the |
||||
|
|
0-1 |
String |
The organization that issued the certificate. |
|
|
|
0-1 |
String |
Certificate issue year. |
|
|
|
0-1 |
String |
Certificate name. |
|
|
Elements of the |
||||
|
|
0-1 |
String |
Review date and time in ISO 8601 format. |
|
|
|
0-1 |
String |
Whether the appointment with the doctor was verified and the review passed moderation. |
|
|
|
0-1 |
String |
Whether the review is included in the rating to be displayed in the doctor profile on the clinic website or on the site. |
|
|
|
0-1 |
String |
The reviewer's name. |
|
|
|
0-1 |
String |
Reviewer ID. |
|
|
|
0-1 |
String |
URL of the reviewer's image. |
|
|
|
0-1 |
String |
Review URL. For example, |
|
|
|
0-1 |
String |
The user's comment, or the review body if there is only one text field in the review form. |
|
|
|
0-1 |
Float |
User rating, from 1 to 5. |
|
|
|
0-1 |
String |
The description of what the reviewer liked (if included in the review). |
|
|
|
0-1 |
String |
The description of what the reviewer didn't like (if included in the review). |
|
|
|
0-1 |
String |
Response to the review on the clinic website or on the site. |
|
|
Elements of the |
||||
|
|
1-inf |
Set of elements |
Clinic description. See an example of using the |
|
|
Elements of the |
||||
|
|
|
1 |
String |
Unique clinic ID. |
|
|
0-1 |
String |
Clinic URL. |
|
|
|
0-1 |
String |
Link to the clinic logo. Image requirements:
|
|
|
|
1 |
String |
The clinic name. As specified in the clinic card in Yandex Business. |
|
|
|
1 |
String |
The address of the clinic. As specified in the clinic card in Yandex Business. |
|
|
|
1 |
String |
The city where the clinic is. |
|
|
|
0-1 |
String |
The clinic's email address. |
|
|
|
0-1 |
String |
Clinic's phone number for appointments. |
|
|
|
0-1 |
String |
Internal clinic ID in the clinic’s or site's information system. Specify if the online schedule is available. |
|
|
|
0-1 |
String |
Organization ID in Yandex Search, numeric value. If the ID wasn't detected automatically, you can use the ID from Yandex Maps:
|
|
|
**Elements of the ** |
||||
|
|
1-inf |
Set of elements |
Doctor’s service description. See an example of using the |
|
|
Elements of the |
||||
|
|
|
1 |
String |
Unique service ID. |
|
|
1 |
String |
Service name. |
|
|
|
0-1 |
String |
Medical service code according to the list of the Ministry of Health of the Russian Federation. |
|
|
|
0-1 |
String |
Service description. |
|
|
|
0-1 |
String |
Internal service ID in the clinic’s or site's information system. Required for generating a search result with an online schedule. Pass one or more parameters. |
|
|
Elements of the |
||||
|
|
1-inf |
Set of elements |
Doctor’s service description. See an example of using the |
|
|
Elements of the |
||||
|
|
|
1 |
String |
Offer ID in the feed. |
|
|
0-1 |
String |
The URL of the offer. |
|
|
|
0-1 |
String |
Online schedule. |
|
|
|
0-1 |
String |
Whether an appointment can be made using the OMS (compulsory health insurance) policy. |
|
|
|
0-1 |
String |
Information about the doctor's availability. |
|
|
|
0-1 |
Set of elements |
Consultation fee. For the fee to be displayed in the doctor card, set |
|
|
|
1 |
String |
Element that contains a link to the offer service. |
|
|
|
|
1 |
String |
ID of one of the services from the |
|
|
1 |
Set of elements |
Links to the clinic, doctor, and offer parameters. |
|
|
**Elements of the ** |
||||
|
|
|
1 |
String |
ID of one of the services from the |
|
|
1 |
Set of elements |
Link to the doctor and offer parameters. |
|
|
Elements of the |
||||
|
|
|
1 |
String |
ID of one of the doctors from the |
|
|
1 |
String |
The doctor's specialty for providing a service from the offer. If the service can be provided under multiple specialties, create multiple offers. For specialties, see List of supported specialties. |
|
|
|
0-1 |
String |
Consultations for children (under 18 years old). Possible values: |
|
|
|
0-1 |
String |
Consultations for adults. Possible values: |
|
|
|
0-1 |
String |
House calls. Possible values: |
|
|
|
0-1 |
String |
Providing a service using telemedicine tools. Possible values: |
|
|
|
0-1 |
String |
The basic service attribute. Possible values: |
|
|
Elements of the |
||||
|
|
1 |
Float |
Basic service price. |
|
|
|
1 |
String |
Currency code. |
|
|
|
1 |
Float |
Discount amount in rubles. |
|
|
|
|
0-1 |
String |
Discount application condition. |
|
|
0-1 |
String |
Free consultation condition. |
|
List of specialties
|
How to submit a feed, requirements, and restrictions
How to submit a feed
You can upload your feed:
-
Log in to Yandex.
-
Add the site to Yandex Webmaster and verify ownership, or get access for your account from a user with the Owner role.
In order to work with feeds, the user needs the Edit or Partial access → Manage feeds role.
-
Go to Services and offers in search results → Feeds and errors.
-
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 service notification describing them will appear on the Services and offers in search results → 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.
Information about the site and offers will be checked by the quality control service within a few days. The feed can be rejected for violations of the rules.
Learn more about working with the feed
Feed requirements
The feed must contain offers with information about specific specialists and the services they provide.
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.
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.
The number of reviews in the card is determined by the number of reviews included in the feed. We recommend that you include all the reviews about the doctor on a specific site or in a clinic in your 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. |
|
Total number of all YML files (service and offer feeds, RSS feeds for Turbo pages with content) for the site and its subdomains |
1000 |
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 med-search@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.
Effective February 16, 2026, 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.
A file in XLSX format
The XLSX file must contain information about the following groups:
-
Information about the partner (the Organization details sheet).
-
Information about clinics (the Clinic details sheet).
-
Information about services (the Services sheet).
-
Information about offers (the Doctors sheet).
-
Additional information about doctors (the More doctor details sheet).
-
Information about reviews (the Doctor reviews sheet).
Note
Download the XLSX template and fill it out following the instructions on the first sheet.
Recommendations for filling out the XLSX file
We recommend entering data in the following order:
-
Organization details sheet. Specify the company's name, email address, site links, and logo.
-
Clinic details sheet. Enter information about all clinics for which you're filling in offers. Values in the
Clinic IDcolumn must be unique. -
Services sheet. Enter information about all services for which you're filling in offers. Values in the
Service namecolumn must be unique. -
Doctors sheet. Offers are generated based on the connection between:
-
The doctor information.
-
The clinic that the doctor works at. In the
Clinic IDcolumn, select one of the clinics that are filled in on the Clinic details sheet. -
The doctor's specialty. In the
Specialtycolumn, select one from the list. -
The provided service. In the
Servicecolumn, select one of the services loaded from the Services sheet and specify an attribute in theBasic servicecolumn. -
Information about the service cost. Fill in the
Fee without discount, rubles,Discount, rubles, andDiscount conditionscolumns. -
Сonsultation type. Fill in the
Adult patients,Child patients,OMS consultation,House calls,Video consultations, andAppointment availabilitycolumns.
-
-
More doctor details sheet. In the
Activity typecolumn, specify additional information about the doctor: education, job, obtained certificates. Select the doctor for whom you're adding information in theDoctor IDcolumn. Doctor IDs are loaded from the Doctors sheet. -
Doctor reviews sheet. One row corresponds to one doctor review. Select the doctor for whom you're adding information in the
Doctor IDcolumn. Doctor IDs are loaded from the Doctors sheet.
Data sets about clinics (the Clinic details sheet) and services (the Services sheet) must contain all the information about clinics and services for which you're filling in the offers (the Doctors sheet).
Specify a clinic, doctor’s specialty, and basic service for each offer.
Note
Indicate the initial appointment as the basic service, except for specialties where this isn't applicable (for example, a sonographer).
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 feed.
XLSX file element description
Note
When filling out the XLSX file, make sure that a separate offer is specified for each doctor’s service in each specialty and clinic.
Example
If doctor Х provides service Y in three clinics (А, В, and С) in two specialties (D and Е), add six offers:
-
Service
Y, clinicА, specialtyD. -
Service
Y, clinicА, specialtyЕ. -
Service
Y, clinicВ, specialtyD. -
Service
Y, clinicВ, specialtyЕ. -
Service
Y, clinicС, specialtyD. -
Service
Y, clinicС, specialtyЕ.
Give the same doctor ID to the offers that are related to the same doctor.
Required elements are marked with * in the table.
|
Cells of the "Organization details" sheet |
|
|
Element |
Description |
|
|
Organization name. |
|
|
Site name to be displayed in doctor cards. The maximum length is 30 characters. |
|
|
The site URL. |
|
|
The contact email address. |
|
|
Link to the site or clinic logo. Image requirements:
Logos on a white background must fill the image area as much as possible. It helps increase the site brand awareness. |
|
Cells of the "Clinic details" sheet |
|
|
|
The clinic name. As specified in the clinic card in Yandex Business. |
|
|
Unique clinic ID. |
|
|
Clinic URL. |
|
|
The clinic's email address. |
|
|
The city where the clinic is. |
|
|
The address of the clinic. As specified in the clinic card in Yandex Business. |
|
|
Clinic's phone number for appointments. |
|
|
If the ID wasn't detected automatically, you can use the ID from Yandex Maps:
|
|
|
The ID that is used in your system. For example, |
|
|
Clinic 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. |
|
Cells of the "Services" sheet |
|
|
|
Unique service name. Used in offers. |
|
|
Service ID from the list of the Ministry of Health of the Russian Federation. |
|
|
Doctor’s service description. |
|
|
The ID that is used in your system. For example, |
|
Cells of the "Doctors" sheet |
|
|
|
The doctor's full name. Make sure to enter it in this order: |
|
|
Unique doctor ID. |
|
|
The URL of the doctor's page on your website. Specify a link to the doctor profile on the site that is used:
|
|
|
The consultation fee at the clinic. Specified in rubles. To display the fee on the doctor card, set parameter |
|
|
The discount amount in rubles. It can't be more than the fee without discount (value in the |
|
|
Conditions for applying the discount. |
|
|
The name of the service specified on the Services sheet. |
|
|
The basic service attribute. The feed must contain one offer with a basic service for each doctor, clinic, and specialty. Possible values: |
|
|
The URL of the page where you can book an appointment. When you navigate to the page, the service specified in the offer is displayed. |
|
|
A text description of the doctor's specialty (will be shown in the card). Enter information about the doctor that couldn't be included in other doctor description fields. |
|
|
One doctor's specialty for providing a service from the offer. If the service can be provided under multiple specialties, create multiple offers (rows on the Doctors sheet). |
|
|
A link to the doctor's photo. Recommendations:
|
|
|
A non-negative integer representing the doctor’s full years of experience. It mustn't contain the year or the year's digits indicating the career start. |
|
|
The ID of the clinic (from the Clinic details sheet) that the offer is related to. |
|
|
A non-negative number of reviews about the doctor on the clinic website. All reviews must be passed on the Doctor reviews sheet. |
|
|
Doctor’s academic degree (if any). Recommended values: PhD in Medicine, MD in Medicine, and others. |
|
|
Doctor’s academic rank (if any). Recommended values: Professor, Associate Professor, and others. |
|
|
Doctor’s category (if any). Recommended values: highest, first, second. |
|
|
Ranks, titles, and distinctions that don't belong in |
|
|
Consultations for adults (over 18 years old). Possible values: |
|
|
Consultations for children (under 18 years old). Possible values: |
|
|
The phone number for making appointments. It can be a substitute number if your site uses number substitution. |
|
|
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: |
|
|
Whether an appointment can be booked through the site providing the file. Possible values: |
|
|
Availability of an online schedule for appointments. Possible values: |
|
|
The ID that is used in your system. For example, |
|
Cells of the "More doctor details" sheet |
|
|
|
The ID of the doctor (when selecting a doctor, IDs are loaded from the Doctors sheet) for whom you're adding additional information. |
|
|
The type of the doctor's activities during the specified period. Possible values:
|
|
|
The name of the institution/organization. For example, Astrakhan State Medical University. |
|
|
The year the doctor started to practice or obtained a certificate. |
|
|
The end year of the activity period. |
|
|
Position and specialty for education, job title for employment, or certificate name. For example, |
|
Cells of the "Doctor reviews" sheet |
|
|
|
The ID of the doctor (when selecting a doctor, IDs are loaded from the Doctors sheet) in the review. |
|
|
The reviewer's name. |
|
|
The ID of the clinic website user. |
|
|
URL of the reviewer's image. |
|
|
Review date and time 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 rating to be displayed in the doctor card on the clinic website. Possible values: |
|
|
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. |
|
|
Response to the review on the clinic website. |
|
|
Review URL. For example, |
List of specialties
When entering data (the Doctors sheet) for each offer, select one specialty for the doctor from the list of supported specialties.
|
How to upload an XLSX file and restrictions
How to upload an XLSX file
-
Log in to Yandex.
-
Add the site to Yandex Webmaster and verify ownership, or get access for your account from a user with the Owner role.
In order to work with feeds, the user needs the Edit or Partial access → Manage feeds role.
-
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 offers in the feed are available on the same terms in all regions, select Russia.
-
Select XLSX file and upload the file.
-
Click Done.
Yandex Webmaster will check the XLSX file. If it contains errors, a service notification describing them will appear on the Services and offers in search results → Feeds and errors page. To learn more, click Errors next to the feed.
Fix the errors, and Yandex Webmaster will check the file again after a certain amount of time.
Information about the site and offers will be checked by the quality control service within a few days. The feed can be rejected for violations of the rules.
XLSX file restrictions
|
XLSX file size |
5 MB |
|
Total number of images |
50,000 |
|
Number of images for one doctor |
not more than 1 |
|
Number of doctors — rows on the Врачи sheet. |
30,000. Data from a file containing more offers won't be used for rich results. 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. |
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 med-search@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.
Effective February 16, 2026, 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.
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.
FAQ
Doctor isn't employed at the clinic, but his information appears in Yandex Search
Yandex Search collects information about doctors automatically. The algorithms forms it from the following data:
- Data provided by partners (for example, medical services aggregators or clinics).
- Data indexed by Yandex bots.
If you notice outdated data about your clinic:
-
Check the feed where you submitted the data about your clinic to Yandex Webmaster. If the information is outdated, make changes and resubmit the YML feed or XLSX file for another check. The data will be updated within 24 hours once your file is approved.
-
Check the specialized sites that could have information about the doctor. Contact the original websites and ask them to update it. You can find links to them in the doctor card under Contact info and links.
The information in search results will be updated within two weeks after the details on the source website is corrected.
If you can't get in touch with the source website, contact its hosting provider.
Yandex Search is showing incorrect information about my clinic
This can happen due to the following reasons:
-
The feed contains outdated information — check that everything is up to date, make changes if necessary, and submit the feed to get it checked.
-
Some industry sites have outdated information about the clinic — contact the source websites and ask them to update the information.
-
There are several cards for the same organization registered in Yandex Business — check the data in the service and keep only one up‑to‑date card.
-
You uploaded a new feed In Yandex Webmaster but didn't delete the old one — delete the outdated feed.
How do I update information in a doctor’s profile card?
Information about doctors in Yandex Search is collected both from clinic feeds and from specialized sites during indexing.
If several primary sources are listed in the doctor’s profile under Contact info and links, their information may be pulled from any of such sources.
To update the information, contact the source websites. The information in search results will be updated within two weeks after the details on the source website is corrected.
Alternatively, you can ask the doctor to verify their profile in the doctor’s card using the Claim ownership button and, for example, to upload their current photo or add education certificates.
For more information about verifying a doctor’s profile, see Yandex ID Help.
The doctor’s card displays an incorrect cost of visit
The cost of services in the doctor’s card next to the buttons Book or Make an appointment is taken from the first source in the list and may not necessarily be the lowest of them all. The information is displayed both from clinic feeds and from specialized sites.
If the cost of appointment is incorrect on any source, contact that site's support team and ask them to update the information.
The information in search results will be updated within two weeks after the details on the source website is corrected.
What is a doctor’s rating, and what determines it?
A doctor’s rating is the percentage of recommendations that may be displayed in verticals, in a doctor’s card, or in a clinic's card in Yandex Search.

The average rating is calculated based on reviews collected by the indexing bot from open sources and feeds uploaded by clinics.
Where do reviews in a doctor’s card come from and how to delete them?
Users can leave reviews:
- On aggregator sites: Yandex Search can pull reviews from an aggregator's feed or during indexing.
- On clinic websites: To make these reviews appear in Yandex Search, submit them in the feed.
- Directly through Yandex.
The review source is shown in Yandex Search. If there is no source, it means the review was left through Yandex.
Algorithms sort reviews by their usefulness: more detailed and recent reviews appear higher.
You can't manually change the order of reviews or delete a review that complies with the publication guidelines.
You can respond to reviews in Yandex Webmaster and Yandex Business. Doctors can also respond to reviews about them in their personal profile.
Learn more:
Page updated: December 9, 2025.
Change history
-
Specified the roles in Yandex Webmaster that allow working with feeds and XLSX files.
-
Added FAQ.
Subscribe to updates
0-1: Not more than one element.
1-inf: At least one element.
0-inf: Any number.