Получение подробной информации о фидах

Возвращает подробную информацию о загруженных YML-фидах. Поддерживает фильтрацию, сортировку и пагинацию.

Формат запроса

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/feeds/status/list
  ? [offset=<int32>]
  & [limit=<int32>]
  & [status=<string>]
  & [type=<string>]
  & [orderBy=<string>]
  & [orderDirection=<string>]

user-id

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

host-id

Тип: string. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

offset

Смещение списка. Минимальное значение — 0. Значение по умолчанию: 0.

limit

Количество записей на странице (1—100). Значение по умолчанию: 50.

status

Фильтр по статусу фида. Возможные значения: IN_PROGRESS — фид проверяется; SUCCESS — фид проверен; ERROR — есть ошибки; MODERATION_FAILED — не удалось пройти проверку качества; MODERATION_BANNED — критический отказ проверки качества; SETS_CHECK_FAILED — не пройдена проверка наборов; EMPTY_FEED — пустой фид; DOWNLOAD_FAILED — проблемы со скачиванием фида.

type

Категория бизнеса, для которого загружен фид. Возможные значения:

  • REALTY — продажа или аренда квартир, офисов, домов и других построек;

  • VACANCY — предложения работы;

  • DOCTORS — информация об услугах врачей (например, прием педиатра);

  • CARS — продажа автомобилей, мотоциклов и других средств передвижения;

  • SERVICES — объявления исполнителей бытовых и других услуг (например, перевозка мебели);

  • EDUCATION — объявления об образовательных курсах или уроках, которые проводятся онлайн (например, курсы программирования).

orderBy

Поле сортировки. Возможные значения:

  • ERRORS_COUNT — по числу ошибок;
  • WARNINGS_COUNT — по числу замечаний;
  • ADDED_TIME — по времени добавления;
  • LAST_ACCESS_TIME — по времени последнего обхода;
  • STATUS — по статусу;
  • MODERATION_REJECTED_OFFERS_COUNT — по числу предложений, отклоненных модерацией.

orderDirection

Направление сортировки: ASC — по возрастанию, DESC — по убыванию. Требует указания параметра orderBy.

Формат ответа

Примеры

{
  "count": 100,
  "feeds": [
    {
      "url": "https://example.com/feeds/feed.yml",
      "type": "SERVICES",
      "regionIds": [225],
      "status": "ERROR",
      "addedTime": "2026-07-20T10:12:00.000+03:00",
      "lastAccessTime": "2026-07-20T10:41:00.000+03:00",
      "errorsCount": 3,
      "warningsCount": 1,
      "moderationRejectedOffersCount": 0
    }
  ]
}

<Data>
    <count>100</count>
    <feed>
        <url>https://example.com/feeds/feed.yml</url>
        <type>SERVICES</type>
        <regionId>225</regionId>
        <status>ERROR</status>
        <addedTime>2026-07-20T10:12:00.000+03:00</addedTime>
        <lastAccessTime>2026-07-20T10:41:00.000+03:00</lastAccessTime>
        <errorsCount>3</errorsCount>
        <warningsCount>1</warningsCount>
        <moderationRejectedOffersCount>0</moderationRejectedOffersCount>
    </feed>
</Data>

Имя

Обязательный

Тип

Описание

count

Да

int32

Общее число фидов под фильтром (до пагинации).

feeds

Да

array

Страница фидов.

feeds[].url

Да

url

URL фида.

feeds[].type

Да

string

Категория бизнеса, для которого загружен фид. Возможные значения:

  • REALTY — продажа или аренда квартир, офисов, домов и других построек;

  • VACANCY — предложения работы;

  • DOCTORS — информация об услугах врачей (например, прием педиатра);

  • CARS — продажа автомобилей, мотоциклов и других средств передвижения;

  • SERVICES — объявления исполнителей бытовых и других услуг (например, перевозка мебели);

  • EDUCATION — объявления об образовательных курсах или уроках, которые проводятся онлайн (например, курсы программирования).

feeds[].regionIds

Да

int32

Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, 1, 2). Если значение не передано, задается значение 225 (Россия).

feeds[].status

Да

string

Статус фида. Возможные значения: IN_PROGRESS — фид проверяется; SUCCESS — фид проверен; ERROR — есть ошибки; MODERATION_FAILED — не удалось пройти проверку качества; MODERATION_BANNED — критический отказ проверки качества; SETS_CHECK_FAILED — не пройдена проверка наборов; EMPTY_FEED — пустой фид; DOWNLOAD_FAILED — проблемы со скачиванием фида.

feeds[].addedTime

Да

datetime

Время добавления фида.

feeds[].lastAccessTime

Да

datetime

Время последнего обхода фида.

feeds[].errorsCount

Да

int64

Число ошибок фида.

feeds[].warningsCount

Да

int64

Число замечаний фида.

feeds[].moderationRejectedOffersCount

Да

int64

Число предложений, отклоненных модерацией.

Коды ответа

Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

Код

Причина

Описание

200

OK

400

ORDER_BY_REQUIRED

Указан orderDirection без orderBy.

403

INVALID_USER_ID

 
{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}

<Data>
    <error_code>INVALID_USER_ID</error_code>
    <available_user_id>1</available_user_id>
    <error_message>Invalid user id. {user_id} should be used.</error_message>
</Data>

404

HOST_NOT_VERIFIED

 
{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}

<Data>
  <error_code>HOST_NOT_VERIFIED</error_code>  
  <host_id>http:ya.ru:80</host_id>
  <error_message>some string</error_message>
</Data>

Узнайте больше

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

Тип: string. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

Смещение списка. Минимальное значение — 0. Значение по умолчанию: 0.

Количество записей на странице (1—100). Значение по умолчанию: 50.

Фильтр по статусу фида. Возможные значения: IN_PROGRESS — фид проверяется; SUCCESS — фид проверен; ERROR — есть ошибки; MODERATION_FAILED — не удалось пройти проверку качества; MODERATION_BANNED — критический отказ проверки качества; SETS_CHECK_FAILED — не пройдена проверка наборов; EMPTY_FEED — пустой фид; DOWNLOAD_FAILED — проблемы со скачиванием фида.

Категория бизнеса, для которого загружен фид. Возможные значения:

  • REALTY — продажа или аренда квартир, офисов, домов и других построек;

  • VACANCY — предложения работы;

  • DOCTORS — информация об услугах врачей (например, прием педиатра);

  • CARS — продажа автомобилей, мотоциклов и других средств передвижения;

  • SERVICES — объявления исполнителей бытовых и других услуг (например, перевозка мебели);

  • EDUCATION — объявления об образовательных курсах или уроках, которые проводятся онлайн (например, курсы программирования).

Поле сортировки. Возможные значения:

  • ERRORS_COUNT — по числу ошибок;
  • WARNINGS_COUNT — по числу замечаний;
  • ADDED_TIME — по времени добавления;
  • LAST_ACCESS_TIME — по времени последнего обхода;
  • STATUS — по статусу;
  • MODERATION_REJECTED_OFFERS_COUNT — по числу предложений, отклоненных модерацией.

Направление сортировки: ASC — по возрастанию, DESC — по убыванию. Требует указания параметра orderBy.

URL фида.

Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, 1, 2). Если значение не передано, задается значение 225 (Россия).

Время добавления фида.

Время последнего обхода фида.

Число ошибок фида.

Число замечаний фида.

Число предложений, отклоненных модерацией.

Предыдущая
Получение списка фидов
Следующая
Получение информации об одном фиде