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:

  1. Information about doctors.

  2. Information about clinics.

  3. Information about services.

  4. 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:

  1. An offer that indicates the basic service.

    Example

    If doctor X works at clinic Y in two specialties (A and B), the feed must contain two offers:

    1.1 Doctor X, clinic Y, specialty A, service Initial appointment.

    1.2 Doctor X, clinic Y, specialty B, service Initial appointment.

  2. A link to the doctor’s profile or a link to the offer in the offer element.

    Example

    This offer can't be used because the URL is specified neither for the doctor, nor for the offer element.

    ...
<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

shop *

1

Set of elements

See an example of using the shop element.

shop *

version *

1

String

Feed version. Specify 2.0.

shop *

date *

1

String

Feed creation date and time in ISO 8601 format.

Elements of the shop content *

name *

1

String

Site name to be displayed in doctor cards. The maximum length is 30 characters.
Displayed in the list of appointment booking sites and in the doctor card under Contact info and links.

company *

1

String

Organization name.
Used for checks, not displayed in the doctor card.

url *

1

String

URL of the site or clinic website.

picture *

1

String

Link to the site or clinic logo. Image requirements:

  • Minimum size: 100 × 100 pixels.

  • The logo can be on the background of any color. You don't have to additionally fit the logo into the circle.

Logos on a white background must fill the image area as much as possible. It helps increase the site brand awareness.

email

0-1

String

The contact email address.

doctors *

1

Set of elements

List of doctor descriptions.
Must contain at least one doctor element.

clinics *

1

Set of elements

List of clinic descriptions.
Must contain at least one clinic element.

services *

1

Set of elements

List of service descriptions.
Must contain at least one service element.

offers *

1

Set of elements

List of descriptions of services provided by the doctor at the clinic.
Must contain at least one offer element.

Elements of the doctors content

doctor *

1-inf

Set of elements

Doctor description.
Fill out one description for each doctor at the clinic or on the site.

See an example of using the doctor element.

Elements of the doctor content *

doctor

id *

1

String

Unique doctor ID in the feed.

name *

1

String

The doctor's full name. Order: last name, first name, patronymic.

url

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 url field isn't specified in the service offers for the doctor.

description

0-1

String

Information about the doctor that couldn't be included in other fields.

internal_id

0-1

String

Internal doctor ID in the clinic’s or site's information system. Specify if the online schedule is available.

first_name

0-1

String

The doctor's first name. Indicate, for example, if the doctor has a double name.

surname

0-1

String

The doctor's last name. Indicate, for example, if the doctor has a double last name or the name field contains a maiden name.

patronymic

0-1

String

Doctor's patronymic. Fill in if the doctor has no patronymic or it is complex.

experience_years

0-1

Integer

Experience in full years.
Don't specify the year or the year's digits indicating the career start.

picture

0-1

String

Link to the doctor's photo. Image recommendations:

  • Dimensions: at least 210 × 210 pixels.

  • Shape: square.

  • Vertical photo.

career_start_date

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.

degree

0-1

String

Doctor’s academic degree. Recommended values: PhD in Medicine, MD in Medicine, and others.

rank

0-1

String

Doctor’s academic rank. Recommended values: Professor, Associate Professor, and others.

category

0-1

String

Doctor's category. Recommended values: highest, first, second.

reviews_total_count

0-1

Integer

Number of reviews about the doctor on the clinic website or on the site.

education

0-inf

Set of elements

Doctor’s education and completed professional training courses.
The doctor element can contain multiple education elements.

job

0-inf

Set of elements

Doctor's jobs.
The doctor element can contain multiple job elements.

certificate

0-inf

Set of elements

Doctor's certificates.
The doctor element can contain multiple certificate elements.

review

0-inf

Set of elements

Reviews about the doctor on the clinic website or on the site.
The number of transmitted reviews must match the value specified in the reviews_total_count field.

Elements of the education content

organization

0-1

String

The educational institution where the doctor obtained a degree. For example, Astrakhan State Medical University.

finish_year

0-1

String

Year of graduation. For example, 2006.

type

0-1

String

Education level: basic, residency, specialty program, and others.

specialization

0-1

String

Specialty.

**Elements of the ** job content

organization

0-1

String

Organizations that the doctor worked at.

period_years

0-1

String

The period of employment with the organization. For example, 2007-2009 or 2009-н.в.(started in 2009, presently working).

position

0-1

String

The job title and specialization. For example, зав. отделением хирургии, врач-педиатр (Chief of Surgery, pediatrician).

Elements of the certificate content

organization

0-1

String

The organization that issued the certificate.

finish_year

0-1

String

Certificate issue year.

name

0-1

String

Certificate name.

Elements of the review content

date

0-1

String

Review date and time in ISO 8601 format.

checked

0-1

String

Whether the appointment with the doctor was verified and the review passed moderation.
Possible values: true or false (default).

used_in_rating

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.
Possible values: true or false (default).

author

0-1

String

The reviewer's name.

author_id

0-1

String

Reviewer ID.

author_picture

0-1

String

URL of the reviewer's image.

url

0-1

String

Review URL. For example, https://example.com/doctor1/reviews?page=2.

comment

0-1

String

The user's comment, or the review body if there is only one text field in the review form.

grade

0-1

Float

User rating, from 1 to 5.

positive

0-1

String

The description of what the reviewer liked (if included in the review).

negative

0-1

String

The description of what the reviewer didn't like (if included in the review).

response

0-1

String

Response to the review on the clinic website or on the site.

Elements of the clinics content

clinic *

1-inf

Set of elements

Clinic description.
One description must be added for each clinic.

See an example of using the clinic element.

Elements of the clinic content *

clinic

id *

1

String

Unique clinic ID.

url

0-1

String

Clinic URL.

picture

0-1

String

Link to the clinic logo. Image requirements:

  • Minimum size: 100 × 100 pixels.

  • The logo can be on the background of any color. You don't have to additionally fit the logo into the circle.

name *

1

String

The clinic name. As specified in the clinic card in Yandex Business.

address *

1

String

The address of the clinic. As specified in the clinic card in Yandex Business.

city *

1

String

The city where the clinic is.

email

0-1

String

The clinic's email address.

phone

0-1

String

Clinic's phone number for appointments.

internal_id

0-1

String

Internal clinic ID in the clinic’s or site's information system. Specify if the online schedule is available.

company_id

0-1

String

Organization ID in Yandex Search, numeric value.
For example, ‪1032739194‬.

If the ID wasn't detected automatically, you can use the ID from Yandex Maps:

  1. Go to the organization card in Yandex Business.

  2. To open the organization profile, click Profile. The numbers in the link will be the organization's ID.
    For example, for the link https://yandex.ru/profile/‪‪1032739194‬‬, the organization's ID is ‪‪1032739194‬‬.

**Elements of the ** services content *

service *

1-inf

Set of elements

Doctor’s service description.
One description must be added for each service provided by the doctor.

See an example of using the service element.

Elements of the service content *

service

id *

1

String

Unique service ID.

name *

1

String

Service name.

gov_id

0-1

String

Medical service code according to the list of the Ministry of Health of the Russian Federation.

description

0-1

String

Service description.

internal_id

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 offers content

offer *

1-inf

Set of elements

Doctor’s service description.
One description must be added for each service provided by the doctor.

See an example of using the offer element.

Elements of the offer content *

offer

id *

1

String

Offer ID in the feed.

url

0-1

String

The URL of the offer.

online_schedule

0-1

String

Online schedule.
Possible values: true or false (default).

oms

0-1

String

Whether an appointment can be made using the OMS (compulsory health insurance) policy.
Possible values: true or false (default).

appointment

0-1

String

Information about the doctor's availability.
Possible values: true or false (default).

price

0-1

Set of elements

Consultation fee. For the fee to be displayed in the doctor card, set appointment to true.

service *

1

String

Element that contains a link to the offer service.

service

id *

1

String

ID of one of the services from the service elements of the services block in the feed.

clinic *

1

Set of elements

Links to the clinic, doctor, and offer parameters.

**Elements of the ** clinic content in offer *

clinic

id *

1

String

ID of one of the services from the clinic elements of the clinics block in the feed.

doctor *

1

Set of elements

Link to the doctor and offer parameters.

Elements of the doctor content in clinic in offer *

doctor

id *

1

String

ID of one of the doctors from the doctor elements of the doctors block.

speciality *

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.

children_appointment

0-1

String

Consultations for children (under 18 years old). Possible values: true or false (default).

adult_appointment

0-1

String

Consultations for adults. Possible values: true or false (default).

house_call

0-1

String

House calls. Possible values: true or false (default).

telemed

0-1

String

Providing a service using telemedicine tools.

Possible values: true or false (default).

is_base_service

0-1

String

The basic service attribute. Possible values: true or false (default).

Elements of the price content in offer *

base_price *

1

Float

Basic service price.

currency *

1

String

Currency code.
Only rubles are currently supported (RUR/RUB).

discount

1

Float

Discount amount in rubles.
The value mustn't exceed the basic service price in the base_price field.

discount

name

0-1

String

Discount application condition.

free_appointment

0-1

String

Free consultation condition.
List of specialties
  • Абдоминальный хирург (Abdominal surgeon)
  • Акушер (Obstetrician)
  • Акушер-гинеколог (Obstetrician-gynecologist)
  • Аллерголог (Allergist)
  • Аллерголог-иммунолог (Allergist-immunologist)
  • Андролог (Andrologist)
  • Анестезиолог (Anesthesiologist)
  • Анестезиолог-реаниматолог (Critical care anesthesiologist)
  • Аритмолог (Arrhythmologist)
  • Артролог (Arthrologist)
  • Бариатрический хирург (Bariatric surgeon)
  • Вегетолог (Autonomic neurologist)
  • Венеролог (Venereologist)
  • Вертебролог (Orthopedic surgeon)
  • Вирусолог (Virologist)
  • Врач лабораторной диагностики (Medical laboratory technician)
  • Врач ЛФК (Physical therapy physician)
  • Врач общей практики (General practitioner)
  • Врач по медико-социальной экспертизе (Medical and social assessment physician)
  • Врач по паллиативной медицинской помощи (Palliative care physician)
  • Врач по спортивной медицине (Sports medicine physician)
  • Врач по рентгенэндоваскулярным диагностике и лечению (Endovascular diagnostics and treatment physician)
  • Врач скорой помощи (Emergency physician)
  • Врач УЗИ (Sonographer)
  • Врач функциональной диагностики (Functional diagnostics physician)
  • Врач эфферентной терапии (Extracorporeal therapy physician)
  • Гастроэнтеролог (Gastroenterologist)
  • Гематолог (Hematologist)
  • Гемостазиолог (Hemostasiologist)
  • Генетик (Geneticist)
  • Гепатолог (Hepatologist)
  • Гериатр (геронтолог) (Geriatrician (gerontologist))
  • Гинеколог (Gynecologist)
  • Гинеколог-эндокринолог (Gynecologist-endocrinologist)
  • Гипнолог (Hypnologist)
  • Гирудотерапевт (Hirudotherapist)
  • Гнатолог (Gnathologist)
  • Гнойный хирург (Purulent surgeon)
  • Дезинфектолог (Infection control specialist)
  • Дерматолог (Dermatologist)
  • Дерматовенеролог (Dermatovenerologist)
  • Дефектолог (Defectologist)
  • Диабетолог (Diabetologist)
  • Диетолог (Dietitian)
  • Иммунолог (Immunologist)
  • Инструктор ЛФК (Physical therapy instructor)
  • Инфекционист (Infectious disease specialist)
  • Кардиолог (Cardiologist)
  • Кардиохирург (Cardiac surgeon)
  • Кинезиолог (Kinesiologist)
  • Кистевой хирург (Hand surgeon)
  • Клинический фармаколог (Clinical pharmacologist)
  • Колопроктолог (проктолог) (Colorectal surgeon (proctologist))
  • Косметолог (Cosmetologist)
  • Лазерный хирург (Laser surgeon)
  • Лимфолог (Lymphologist)
  • Логопед (Speech therapist)
  • Отоларинголог (Otolaryngologist)
  • Малоинвазивный хирург (Minimally invasive surgeon)
  • Маммолог (Mammologist)
  • Мануальный терапевт (Manual therapist)
  • Массажист (Massage therapist)
  • Миколог (Mycologist)
  • Нарколог (Narcologist)
  • Невролог (Neurologist)
  • Нейропсихолог (Neuropsychologist)
  • Нейрофизиолог (Neurophysiologist)
  • Нейрохирург (Neurosurgeon)
  • Неонатолог (Neonatologist)
  • Нефролог (Nephrologist)
  • Нутрициолог (Nutritionist)
  • Ожоговый хирург (комбустиолог) (Burn surgeon (combustiologist))
  • Онкогинеколог (Gynecologic oncologist)
  • Онкодерматолог (Dermatologic oncologist)
  • Онколог (Oncologist)
  • Онколог-гематолог (Hematologic oncologist)
  • Онкопроктолог (Colorectal oncologist)
  • Онкоуролог (Urologic oncologist)
  • Оптометрист (Optometrist)
  • Ортопед (Orthopedist)
  • Остеопат (Osteopathic physician)
  • Отоневролог (Otoneurologist)
  • Офтальмолог (окулист) (Ophthalmologist)
  • Офтальмолог-протезист (Ophthalmic prosthetist)
  • Офтальмохирург (Eye surgeon)
  • Паразитолог (Parasitologist)
  • Патологоанатом (Pathologist)
  • Педиатр (Pediatrician)
  • Перинатолог (Perinatologist)
  • Пластический хирург (Plastic surgeon)
  • Подиатр (Podiatrist)
  • Подолог (Podiatrist)
  • Профпатолог (Occupational physician)
  • Психиатр (Psychiatrist)
  • Психолог (Psychologist)
  • Психотерапевт (Psychotherapist)
  • Пульмонолог (Pulmonologist)
  • Радиолог (Radiologist)
  • Радиотерапевт (Radiation therapist)
  • Реабилитолог (Rehabilitation physician)
  • Реаниматолог (Critical care physician)
  • Ревматолог (Rheumatologist)
  • Рентгенолог (Radiologist)
  • Репродуктолог (Reproductive medicine specialist)
  • Рефлексотерапевт (Reflexologist)
  • Сексолог (Sexologist)
  • Семейный врач (Family doctor)
  • Сердечно-сосудистый хирург (Cardiovascular surgeon)
  • Сомнолог (Somnologist)
  • Сосудистый хирург (Vascular surgeon)
  • Специалист по грудному вскармливанию (Lactation consultant)
  • Спортивный врач (Sports medicine physician)
  • Стоматолог (Dentist)
  • Стоматолог-гигиенист (Dental hygienist)
  • Стоматолог-имплантолог (Implant dentist)
  • Стоматолог-ортодонт (Orthodontist)
  • Cтоматолог-ортопед (Prosthodontist)
  • Стоматолог-пародонтолог (Periodontist)
  • Cтоматолог-терапевт (Dental therapist)
  • Стоматолог-хирург (Dental surgeon)
  • Cтоматолог-эндодонт (Endodontist)
  • Судебно-медицинский эксперт (Forensic pathologist)
  • Cурдолог (Audiologist)
  • Сурдолог-протезист (Audiologist-prosthetist)
  • Терапевт (General practitioner)
  • Токсиколог (Toxicologist)
  • Торакальный онколог (Thoracic oncologist)
  • Торакальный хирург (Thoracic surgeon)
  • Травматолог (Traumatologist)
  • Трансплантолог (Transplantologist)
  • Трансфузиолог (Transfusion medicine specialist)
  • Трихолог (Trichologist)
  • Уролог (Urologist)
  • Физиотерапевт (Physical therapist)
  • Фитотерапевт (Herbalist)
  • Флеболог (Phlebologist)
  • Фониатр (Phoniatrist)
  • Фтизиатр (Phthisiologist)
  • Химиотерапевт (Chemotherapist)
  • Хирург (Surgeon)
  • Хирург-эндокринолог (Endocrine surgeon)
  • Цитолог (Cytologist)
  • Челюстно-лицевой хирург (Oral and maxillofacial surgeon)
  • Эмбриолог (Embryologist)
  • Эндоваскулярный хирург (Endovascular surgeon)
  • Эндокринолог (Endocrinologist)
  • Эндоскопист (Endoscopist)
  • Эпидемиолог (Epidemiologist)
  • Эпилептолог (Epileptologist)
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 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. Select the Doctors business category if you're providing information about doctors' services. For example, an appointment with a pediatrician.

  3. Specify the region. For example, if offers in the feed are available on the same terms in all regions, select Russia.

  4. Select YML and upload the feed.

  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.

The website and offer information will also 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

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.

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 specific site or in a clinic in your feed, because the number of reviews 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 offer element

200

Number of offer elements

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 in the subject line.

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 November 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.

A file in XLSX format

Alert

An XLSX file template was updated. You can upload a file in the new format starting September 8, 2025. Prior to that date, you can submit information about doctors in the old format XLSX file.

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:

  1. Organization details sheet. Specify the company's name, email address, site links, and logo.

  2. Clinic details sheet. Enter information about all clinics for which you're filling in offers. Values in the Clinic ID column must be unique.

  3. Services sheet. Enter information about all services for which you're filling in offers. Values in the Service name column must be unique.

  4. Doctors sheet. Offers are generated based on the connection between:

    • The doctor information.

    • The clinic that the doctor works at. In the Clinic ID column, select one of the clinics that are filled in on the Clinic details sheet.

    • The doctor's specialty. In the Specialty column, select one from the list.

    • The provided service. In the Service column, select one of the services loaded from the Services sheet and specify an attribute in the Basic service column.

    • Information about the service cost. Fill in the Fee without discount, rubles, Discount, rubles, and Discount conditions columns.

    • Сonsultation type. Fill in the Adult patients, Child patients, OMS consultation, House calls, Video consultations, and Appointment availability columns.

  5. More doctor details sheet. In the Activity type column, specify additional information about the doctor: education, job, obtained certificates. Select the doctor for whom you're adding information in the Doctor ID column. Doctor IDs are loaded from the Doctors sheet.

  6. Doctor reviews sheet. One row corresponds to one doctor review. Select the doctor for whom you're adding information in the Doctor ID column. 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:

  1. Service Y, clinic А, specialty D.

  2. Service Y, clinic А, specialty Е.

  3. Service Y, clinic В, specialty D.

  4. Service Y, clinic В, specialty Е.

  5. Service Y, clinic С, specialty D.

  6. 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

Название компании (Company name) *

Organization name.

Название площадки (Site name) *

Site name to be displayed in doctor cards. The maximum length is 30 characters.

Ссылка на сайт компании (Link to company site) *

The site URL.

Электронная почта компании (Company's email address)

The contact email address.

Ссылка на логотип компании (Link to company logo) *

Link to the site or clinic logo. Image requirements:

  • Minimum size: 100 × 100 pixels.

  • The logo can be on the background of any color. You don't have to additionally fit the logo into the circle.

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

Название клиники (Clinic name) *

The clinic name. As specified in the clinic card in Yandex Business.

Идентификатор клиники (Clinic ID) *

Unique clinic ID.

Ссылка на сайт клиники (Link to clinic site)

Clinic URL.

Электронная почта клиники (Clinic's email address)

The clinic's email address.

Город клиники (Clinic city) *

The city where the clinic is.

Адрес клиники (Clinic address) *

The address of the clinic. As specified in the clinic card in Yandex Business.

Телефон клиники (Clinic phone number)

Clinic's phone number for appointments.

Идентификатор организации в поиске (Organization ID in Yandex Search)

If the ID wasn't detected automatically, you can use the ID from Yandex Maps:

  1. Go to the organization card in Yandex Business.

  2. To open the organization profile, click Profile. The numbers in the link will be the organization's ID.

    For example, for the link https://yandex.ru/profile/‪‪1032739194‬‬, the organization's ID is ‪‪1032739194‬‬.

Внутренний идентификатор клиники (Internal clinic ID)

The ID that is used in your system. For example, id123. Required for generating a search result with doctor schedules.

URL логотипа клиники (Clinic logo URL) *

Clinic logo. Requirements:

  • Minimum size: 100 × 100 pixels.

  • The logo can be on the background of any color. You don't have to additionally fit the logo into the circle.

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

Название услуги (Service name) *

Unique service name. Used in offers.

Код услуги в справочнике (Service code in the reference)

Service ID from the list of the Ministry of Health of the Russian Federation.

Описание услуги (Service description)

Doctor’s service description.

Внутренний идентификатор услуги (Internal service ID)

The ID that is used in your system. For example, id123. Required for generating a search result with doctor schedules.

Cells of the "Doctors" sheet

ФИО врача (Doctor's full name) *

The doctor's full name. Make sure to enter it in this order: last name, first name, patronymic.

Идентификатор врача (Doctor ID) *

Unique doctor ID.

URL карточки врача (Doctor card URL) *

The URL of the doctor's page on your website. Specify a link to the doctor profile on the site that is used:

  • In the Contact info and links section.

  • In links to the information source.

  • In the list of links to appointment booking sites if the url field isn't specified in the service offers for that doctor.

Стоимость без скидки, руб (Fee without discount, rubles)

The consultation fee at the clinic. Specified in rubles. To display the fee on the doctor card, set parameter Appointment availability to TRUE.

Скидка, руб (Discount, rubles)

The discount amount in rubles. It can't be more than the fee without discount (value in the Fee without discount column).

Условия для скидки (Discount conditions)

Conditions for applying the discount.

Услуга (Service) *

The name of the service specified on the Services sheet.

Базовая услуга (Basic service)

The basic service attribute.

The feed must contain one offer with a basic service for each doctor, clinic, and specialty. Possible values: yes or no (default).

URL страницы для записи
к врачу на получение
указанной услуги
по указанной специальности (URL of the appointment booking page for receiving the specified service in the given specialty)

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.

Описание врача (Doctor description)

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.

Специальность врача (Doctor's specialty) *

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).

See List of supported specialties.

URL изображения доктора (URL of the doctor's image)

A link to the doctor's photo. Recommendations:

  • Dimensions: at least 210 × 210 pixels.

  • Shape: square.

  • Vertical photo.

Стаж, полных лет (Experience, in full years)

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.

Идентификатор клиники (Clinic ID) *

The ID of the clinic (from the Clinic details sheet) that the offer is related to.

Число отзывов (Number of reviews)

A non-negative number of reviews about the doctor on the clinic website. All reviews must be passed on the Doctor reviews sheet.

Степень (Academic degree)

Doctor’s academic degree (if any). Recommended values: PhD in Medicine, MD in Medicine, and others.

Звание (Rank)

Doctor’s academic rank (if any). Recommended values: Professor, Associate Professor, and others.

Категория (Category)

Doctor’s category (if any). Recommended values: highest, first, second.

Прочие титулы (Other titles)

Ranks, titles, and distinctions that don't belong in Степень, Звание, or Категория. Must be comma-separated.

Взрослый врач (Adult patients)

Consultations for adults (over 18 years old). Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Детский врач (Child patients)

Consultations for children (under 18 years old). Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Телефон для записи (Phone number for appointments)

The phone number for making appointments. It can be a substitute number if your site uses number substitution.

Прием по ОМС (OMS consultation)

Whether an appointment can be made using the OMS (compulsory health insurance) policy. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Вызов на дом (House calls)

Whether house calls can be made. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Прием по видеосвязи (Video consultations)

The availability of video consultations (telemedicine). Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default). If the doctor gives video consultations, the offer can be shown in all Russian regions.

Возможность записи (Appointment availability)

Whether an appointment can be booked through the site providing the file. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Онлайн-расписание (Online schedule)

Availability of an online schedule for appointments. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Внутренний идентификатор врача (Internal doctor ID)

The ID that is used in your system. For example, id123. Required for generating a search result with doctor schedules.

Cells of the "More doctor details" sheet

Идентификатор врача (Doctor ID) *

The ID of the doctor (when selecting a doctor, IDs are loaded from the Doctors sheet) for whom you're adding additional information.

Тип деятельности (Activity type)

The type of the doctor's activities during the specified period. Possible values:

  • Место работы (Job).

  • Образование (Education).

  • Сертификат (Certificate).

Организация (Organization).

The name of the institution/organization. For example, Astrakhan State Medical University.

Период Начало (Period start)

The year the doctor started to practice or obtained a certificate.

Период Конец (Period end)

The end year of the activity period.

Название (Name)

Position and specialty for education, job title for employment, or certificate name. For example, зав. отделением хирургии, врач-педиатр (Chief of Surgery, pediatrician).

Cells of the "Doctor reviews" sheet

Идентификатор врача (Doctor ID) *

The ID of the doctor (when selecting a doctor, IDs are loaded from the Doctors sheet) in the review.

Автор отзыва (Reviewer)

The reviewer's name.

Идентификатор автора (Reviewer ID)

The ID of the clinic website user.

Ссылка на аватар автора (Link to reviewer's avatar)

URL of the reviewer's image.

Дата и время (Date and time)

Review date and time in ISO 8601 format.

Отзыв проверен (Review verified)

Whether the appointment with the doctor was verified and the review passed moderation. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Отзыв участвует в рейтинге (Review included in average rating)

Whether the review is included in the rating to be displayed in the doctor card on the clinic website. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Оценка (Rating)

User rating, from 1 to 5.

Что понравилось (What reviewer liked)

The description of what the reviewer liked (if included in the review).

Что не понравилось (What reviewer disliked)

The description of what the reviewer didn't like (if included in the review).

Комментарий (Comment)

The user's comment, or the review body if there is only one text field in the review form.

Ответ на отзыв (Response to review)

Response to the review on the clinic website.

Ссылка (URL)

Review URL. For example, https://example.com/doctor1/reviews?page=2.
List of specialties

When entering data (the Doctors sheet) for each offer, select one specialty for the doctor from the list of supported specialties.

  • Абдоминальный хирург (Abdominal surgeon)
  • Акушер (Obstetrician)
  • Акушер-гинеколог (Obstetrician-gynecologist)
  • Аллерголог (Allergist)
  • Аллерголог-иммунолог (Allergist-immunologist)
  • Андролог (Andrologist)
  • Анестезиолог (Anesthesiologist)
  • Анестезиолог-реаниматолог (Critical care anesthesiologist)
  • Аритмолог (Arrhythmologist)
  • Артролог (Arthrologist)
  • Бариатрический хирург (Bariatric surgeon)
  • Вегетолог (Autonomic neurologist)
  • Венеролог (Venereologist)
  • Вертебролог (Orthopedic surgeon)
  • Вирусолог (Virologist)
  • Врач лабораторной диагностики (Medical laboratory technician)
  • Врач ЛФК (Physical therapy physician)
  • Врач общей практики (General practitioner)
  • Врач по медико-социальной экспертизе (Medical and social assessment physician)
  • Врач по паллиативной медицинской помощи (Palliative care physician)
  • Врач по спортивной медицине (Sports medicine physician)
  • Врач по рентгенэндоваскулярным диагностике и лечению (Endovascular diagnostics and treatment physician)
  • Врач скорой помощи (Emergency physician)
  • Врач УЗИ (Sonographer)
  • Врач функциональной диагностики (Functional diagnostics physician)
  • Врач эфферентной терапии (Extracorporeal therapy physician)
  • Гастроэнтеролог (Gastroenterologist)
  • Гематолог (Hematologist)
  • Гемостазиолог (Hemostasiologist)
  • Генетик (Geneticist)
  • Гепатолог (Hepatologist)
  • Гериатр (геронтолог) (Geriatrician (gerontologist))
  • Гинеколог (Gynecologist)
  • Гинеколог-эндокринолог (Gynecologist-endocrinologist)
  • Гипнолог (Hypnologist)
  • Гирудотерапевт (Hirudotherapist)
  • Гнатолог (Gnathologist)
  • Гнойный хирург (Purulent surgeon)
  • Дезинфектолог (Infection control specialist)
  • Дерматолог (Dermatologist)
  • Дерматовенеролог (Dermatovenerologist)
  • Дефектолог (Defectologist)
  • Диабетолог (Diabetologist)
  • Диетолог (Dietitian)
  • Иммунолог (Immunologist)
  • Инструктор ЛФК (Physical therapy instructor)
  • Инфекционист (Infectious disease specialist)
  • Кардиолог (Cardiologist)
  • Кардиохирург (Cardiac surgeon)
  • Кинезиолог (Kinesiologist)
  • Кистевой хирург (Hand surgeon)
  • Клинический фармаколог (Clinical pharmacologist)
  • Колопроктолог (проктолог) (Colorectal surgeon (proctologist))
  • Косметолог (Cosmetologist)
  • Лазерный хирург (Laser surgeon)
  • Лимфолог (Lymphologist)
  • Логопед (Speech therapist)
  • Отоларинголог (Otolaryngologist)
  • Малоинвазивный хирург (Minimally invasive surgeon)
  • Маммолог (Mammologist)
  • Мануальный терапевт (Manual therapist)
  • Массажист (Massage therapist)
  • Миколог (Mycologist)
  • Нарколог (Narcologist)
  • Невролог (Neurologist)
  • Нейропсихолог (Neuropsychologist)
  • Нейрофизиолог (Neurophysiologist)
  • Нейрохирург (Neurosurgeon)
  • Неонатолог (Neonatologist)
  • Нефролог (Nephrologist)
  • Нутрициолог (Nutritionist)
  • Ожоговый хирург (комбустиолог) (Burn surgeon (combustiologist))
  • Онкогинеколог (Gynecologic oncologist)
  • Онкодерматолог (Dermatologic oncologist)
  • Онколог (Oncologist)
  • Онколог-гематолог (Hematologic oncologist)
  • Онкопроктолог (Colorectal oncologist)
  • Онкоуролог (Urologic oncologist)
  • Оптометрист (Optometrist)
  • Ортопед (Orthopedist)
  • Остеопат (Osteopathic physician)
  • Отоневролог (Otoneurologist)
  • Офтальмолог (окулист) (Ophthalmologist)
  • Офтальмолог-протезист (Ophthalmic prosthetist)
  • Офтальмохирург (Eye surgeon)
  • Паразитолог (Parasitologist)
  • Патологоанатом (Pathologist)
  • Педиатр (Pediatrician)
  • Перинатолог (Perinatologist)
  • Пластический хирург (Plastic surgeon)
  • Подиатр (Podiatrist)
  • Подолог (Podiatrist)
  • Профпатолог (Occupational physician)
  • Психиатр (Psychiatrist)
  • Психолог (Psychologist)
  • Психотерапевт (Psychotherapist)
  • Пульмонолог (Pulmonologist)
  • Радиолог (Radiologist)
  • Радиотерапевт (Radiation therapist)
  • Реабилитолог (Rehabilitation physician)
  • Реаниматолог (Critical care physician)
  • Ревматолог (Rheumatologist)
  • Рентгенолог (Radiologist)
  • Репродуктолог (Reproductive medicine specialist)
  • Рефлексотерапевт (Reflexologist)
  • Сексолог (Sexologist)
  • Семейный врач (Family doctor)
  • Сердечно-сосудистый хирург (Cardiovascular surgeon)
  • Сомнолог (Somnologist)
  • Сосудистый хирург (Vascular surgeon)
  • Специалист по грудному вскармливанию (Lactation consultant)
  • Спортивный врач (Sports medicine physician)
  • Стоматолог (Dentist)
  • Стоматолог-гигиенист (Dental hygienist)
  • Стоматолог-имплантолог (Implant dentist)
  • Стоматолог-ортодонт (Orthodontist)
  • Cтоматолог-ортопед (Prosthodontist)
  • Стоматолог-пародонтолог (Periodontist)
  • Cтоматолог-терапевт (Dental therapist)
  • Стоматолог-хирург (Dental surgeon)
  • Cтоматолог-эндодонт (Endodontist)
  • Судебно-медицинский эксперт (Forensic pathologist)
  • Cурдолог (Audiologist)
  • Сурдолог-протезист (Audiologist-prosthetist)
  • Терапевт (General practitioner)
  • Токсиколог (Toxicologist)
  • Торакальный онколог (Thoracic oncologist)
  • Торакальный хирург (Thoracic surgeon)
  • Травматолог (Traumatologist)
  • Трансплантолог (Transplantologist)
  • Трансфузиолог (Transfusion medicine specialist)
  • Трихолог (Trichologist)
  • Уролог (Urologist)
  • Физиотерапевт (Physical therapist)
  • Фитотерапевт (Herbalist)
  • Флеболог (Phlebologist)
  • Фониатр (Phoniatrist)
  • Фтизиатр (Phthisiologist)
  • Химиотерапевт (Chemotherapist)
  • Хирург (Surgeon)
  • Хирург-эндокринолог (Endocrine surgeon)
  • Цитолог (Cytologist)
  • Челюстно-лицевой хирург (Oral and maxillofacial surgeon)
  • Эмбриолог (Embryologist)
  • Эндоваскулярный хирург (Endovascular surgeon)
  • Эндокринолог (Endocrinologist)
  • Эндоскопист (Endoscopist)
  • Эпидемиолог (Epidemiologist)
  • Эпилептолог (Epileptologist)
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 your management rights, or get access for your account from the site owner.

  1. In Yandex Webmaster, go to Services and offers in search results → Feeds and errors.

  2. Click Upload feed.

  3. Choose the Doctors business category.

  4. Specify the region. For example, if the offers in the file are available on the same terms in all Russian regions, select Russia.

  5. Select XLSX file and upload the file.

  6. 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.

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 in the subject line.

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 November 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.

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: August 29, 2025.

Change history
  • Changed the date of transition to a paid contract for submitting data on the doctors' schedules.
  • Updated the support service address for integration.
Subscribe to updates

Contact support

Choose a category:

Fill out the form below if the data relates to the following categories: Education, Performers, Realty, Vehicles, Vacancies, Doctors.

The team will try to take your opinion into account in the future updates.




You can also go to

Element

Set IDs. You can list several sets separated by commas, for example: s1,s2,s3.

0-1: Not more than one element.

1-inf: At least one element.

0-inf: Any number.

Previous
Sporting event videos
Next
Quality control