---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/ru/concepts/feeds.md
  - href: https://yandex.ru/dev/webmaster/doc/ru/concepts/feeds.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/webmaster/doc/ru/llms.txt?revision=r21838267
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/ru/llms.txt?revision=r21838267

# Пример управления YML-фидами для дополненного представления в поиске


{% note info %}

Дополненное представление в поиске находится в режиме бета-тестирования.

{% endnote %}

Вы можете бесплатно показывать больше услуг и предложений потенциальным клиентам в результатах поиска Яндекса. Пользователи смогут ближе познакомиться с вашими предложениями и услугами прямо в поисковой выдаче и еще на этапе поиска понять, есть ли на вашем сайте то, что им нужно. Подробно см. [Дополненное представление в поиске Яндекса.](https://yandex.ru/support/webmaster/feed/about.html)

Данные передаются Яндексу в формате YML-файла (фида). [Стандарт YML](https://yandex.ru/support/partnermarket/export/yml.html) (Yandex Market Language) разработан Яндексом и основан на стандарте XML.

Поддерживается YML-файл с расширением `xml`, `yml` или в виде архива `gzip`. Убедитесь, что HTTP-заголовок `Content-type`, который передает ваш сервер, содержит тип ресурса `application/xml`, `application/octet-stream` или `text/xml`.

С помощью API Вебмастера вы можете управлять ранее подготовленным фидом: загружать, проверять статус и ошибки, удалять. Операции доступны для сайтов, которые используют протокол HTTPS.

Ниже приведен пример работы с фидами.

## Шаг 1. Получите OAuth-токен {#oauth}

Для работы с API получите [авторизационный токен](https://yandex.ru/dev/webmaster/doc/ru/tasks/how-to-get-oauth.md). Передавайте его в каждом запросе в HTTP-заголовке Authorization.

## Шаг 2. Получите идентификатор пользователя {#user-id}

Идентификатор пользователя нужен при вызове ресурсов API. Он передается в path-параметре `user-id`. Чтобы получить идентификатор, используйте метод [GET /v4/user](https://yandex.ru/dev/webmaster/doc/ru/reference/user.md).

Идентификатор пользователя возвращается в поле `user-id`.

## Шаг 3. Добавьте сайт в Вебмастер и подтвердите права

1. Чтобы добавить сайт в Вебмастер, используйте метод [POST /v4/user/{user-id}/hosts](https://yandex.ru/dev/webmaster/doc/ru/reference/hosts-add-site.md).
1. Чтобы подтвердить права на управление сайтом в Вебмастере, [воспользуйтесь инструкцией](https://yandex.ru/dev/webmaster/doc/ru/concepts/verification.md).

## Шаг 4. Загрузите фид в Вебмастер {#upload}

API Вебмастера позволяет загрузить несколько фидов:

{% list tabs %}

- Асинхронно

  
  Если фиды долго генерируются, используйте метод [POST /v4/user/{user_id}/hosts/{host_id}/feeds/add/start/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-add-start.md). Он позволяет асинхронно выполнить загрузку фида — параллельно можно запустить до 50 загрузок.
  
  Затем отслеживайте статус загрузки каждого из фидов с помощью метода [GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-add-info.md).
  

- В одном запросе

  Чтобы передать одновременно до 50 фидов, используйте метод [POST /v4/user/{user_id}/hosts/{host_id}/feeds/batch/add/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-batch-add.md).

{% endlist %}

Загружая фид, вы соглашаетесь с [условиями использования сервиса](https://yandex.ru/legal/webmaster_fid/).{#offer}

## Шаг 5. Получите информацию о фиде {#check-status}

После загрузки фид будет проверен. Проверка занимает некоторое время. Статус проверки и число ошибок по фиду можно получить методом [GET /v4/user/{user_id}/hosts/{host_id}/feeds/info/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-info.md) — передайте URL фида в параметре `url`.

Если в ответе `status` — `ERROR`, в фиде есть ошибки.

Тот же статус можно посмотреть в интерфейсе Вебмастера: **Услуги и предложения в поиске** → **Фиды и ошибки**.

## Шаг 6. Получите ошибки и исправьте фид {#fix}

Для этого используйте метод [GET /v4/user/{user_id}/hosts/{host_id}/feeds/problems/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-problems.md) — передайте URL фида в параметре `url`.

Прочитайте сообщения об ошибках и исправьте их. В течение некоторого времени фид будет проверен снова.