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

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.

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)
  • Врач функциональной диагностики (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)
  • Рентгенолог (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)
  • Sonographer
  • Уролог (Urologist)
  • Физиотерапевт (Physical therapist)
  • Фитотерапевт (Herbalist)
  • Флеболог (Phlebologist)
  • Фониатр (Phoniatrist)
  • Фтизиатр (Phthisiologist)
  • Химиотерапевт (Chemotherapist)
  • Хирург (Surgeon)
  • Хирург-эндокринолог (Endocrine surgeon)
  • Цитолог (Cytologist)
  • Челюстно-лицевой хирург (Oral and maxillofacial surgeon)
  • Эмбриолог (Embryologist)
  • Эндоваскулярный хирург (Endovascular surgeon)
  • Эндокринолог (Endocrinologist)
  • Эндоскопист (Endoscopist)
  • Эпидемиолог (Epidemiologist)
  • Эпилептолог (Epileptologist)
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

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

A short and clear site name for display in the card. Up to 30 characters.

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

Organization name.

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

The site URL.

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

The contact email address.

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

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

Columns 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) *

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.

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

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: ?offer_id=<ID value>.

Стоимость (Fee) *

The consultation fee when booking an appointment through the feed's source (discounts included).

The parameter Minimum fee with the value TRUE indicates the fee "from..." If the fee is unknown or the first appointment is free, enter 0 (paired with the value Fee unknown in the Service parameter).

To display the fee on the doctor card, set parameter Appointment availability to TRUE.

Цена от (Minimum fee) *

Enter ИСТИНА (TRUE) if the fee isn't fixed.

Стоимость без скидки (Fee without discount);

The appointment fee at the clinic (without the discount if the Fee element indicates the fee with the discount included). Can't be lower than the value of the Fee.

Услуга (Service)

The service. Possible values:

  • Первичный прием (initial consultation).
  • Цена неизвестна (fee unknown).

Специальности врача через запятую (Doctor's specialties separated by commas) *

A list of the doctor's specialties, with values separated by commas.

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.

Optional.

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

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.

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

Whole number.

Начало карьеры (Start of career).

Career start date in ISO 8601 format.

Город (City) *

The city where the doctor gives consultations.

Взрослый врач (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).

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

The total number of reviews that can be read at this doctor's URL. Default value — 0.

Степень (Academic degree)

"Кандидат наук" (Candidate of Sciences) or "Доктор наук" (Doctor of Sciences).

Звание (Rank)

"Профессор" (professor) or "Доцент" (docent).

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

"Первая категория", "Вторая категория", or "Высшая категория" (first, second, or superior grade).

Город клиники (City of the clinic).

The city where the clinic is.

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

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

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

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

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

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

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

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.

Organization ID

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

  1. Go to the organization's 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 doctor ID)

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.

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

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

Прием по ОМС (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.

Columns of the "Доп информация врача (More doctor details)" sheet

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

A doctor whose information is fully specified on the Врачи sheet.

Type

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

  • Место работы (Job).
  • Образование (Education).
  • Сертификат (Certificate).

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

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

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

The start year of the activity period.

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

The end year of the activity period.

Optional.

Название (Name)

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

"Отзывы о враче (Doctor reviews)" sheet

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

A doctor whose information is fully specified on the Врачи sheet.

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

The reviewer's name.

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

Required for distinguishing between reviewers with identical names.

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

The URL of an image.

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

Review date 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 average rating for displaying the doctor card. Possible values: ИСТИНА (TRUE) or ЛОЖЬ (FALSE, default).

Оценка (Rating)

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

The response to the review.

Ссылка (URL)

Review URL. For example, https://example.com/doctor1/reviews?page=2.
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 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.

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.

Element

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