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

Возвращает подробную информацию об одном YML-фиде по его URL.

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

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/feeds/info
  ? url=<url>

user-id

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

host-id

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

url*

URL фида.

* Обязательный параметр

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

Примеры

{
  "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:12:00.000+03:00",
  "errorsCount": 3,
  "warningsCount": 1,
  "moderationRejectedOffersCount": 0
}
<Data>
    <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>
</Data>

Имя

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

Тип

Описание

url

Да

url

URL фида.

type

Да

string

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

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

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

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

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

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

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

regionIds

Да

int32

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

status

Да

string

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

addedTime

Да

datetime

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

lastAccessTime

Да

datetime

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

errorsCount

Да

int64

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

warningsCount

Да

int64

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

moderationRejectedOffersCount

Да

int64

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

Коды ответа

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

Код

Причина

Описание

200

OK

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

INCORRECT_URL

{
  "error_code": "INCORRECT_URL",
  "error_message": "some string"
}
<Data>
  <error_code>INCORRECT_URL</error_code>  
  <error_message>some string</error_message>
</Data>

404

FEED_NOT_FOUND

Фид с указанным URL не найден у сайта.

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.

URL фида.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

* Обязательный параметр