---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-add-start.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/ru/llms.txt

# Асинхронная загрузка фида

Асинхронно добавляет YML-фиды для загрузки в Вебмастер. Используйте этот метод, если фиды долго генерируются.

<!-- source: ru/_includes/concepts/feeds/id-feeds/offer.md -->
Загружая фид, вы соглашаетесь с [условиями использования сервиса](https://yandex.ru/legal/webmaster_fid/).
<!-- endsource: ru/_includes/concepts/feeds/id-feeds/offer.md -->


## Формат запроса {#request-format}

```
POST https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}/feeds/add/start
```

#|
||
`user-id`
|
    
<!-- source: ru/_includes/popup/user-id.md -->
Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.ru/dev/webmaster/doc/ru/reference/user.md).
<!-- endsource: ru/_includes/popup/user-id.md -->
    
||
||
`host-id`
|
    
<!-- source: ru/_includes/popup/host-id.md -->
Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET&nbsp;/v4/user/{user&#x2011;id}/hosts](https://yandex.ru/dev/webmaster/doc/ru/reference/hosts.md).
<!-- endsource: ru/_includes/popup/host-id.md -->

||
|#

### Пример


{% list tabs %}

- JSON

  
  ```javascript
  {
    "feed": {
      "url": "https://example.com/some/path?a=b",
      "type": "REALTY",
      "regionIds": [
        225
      ]
    }
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <feed>
          <[url](*url)>https://example.com/some/path?a=b</url>
          <[type](*type)>REALTY</type>
          <[regionIds](*regionIds)>225</region_ids>
      </feed>
  </Data>
  ```

{% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
||
||

`url`
|
Да
|
`url`
|
<!-- source: ru/_includes/popup/id-changelog/feed-url.md -->
URL фида.
<!-- endsource: ru/_includes/popup/id-changelog/feed-url.md -->


<!-- source: ru/_includes/popup/id-changelog/feed-url2.md -->
Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: `https://yandex:WE9h4FfBml@example.com/feed.yml`.
<!-- endsource: ru/_includes/popup/id-changelog/feed-url2.md -->
||
||
`type`
|
Да
|
`string`
|
<!-- source: ru/_includes/popup/id-changelog/feed-type.md -->
Категория бизнеса, для которого загружен фид. Возможные значения:
- `REALTY` — продажа или аренда квартир, офисов, домов и других построек;

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

- `GOODS` — продажа электроники, бытовой техники, строительных материалов, книг, запчастей и пр.;

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

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

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

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

- `ACTIVITY` — продажа билетов на развлекательные услуги.
<!-- endsource: ru/_includes/popup/id-changelog/feed-type.md -->
||
||
`regionIds`
|
Нет

|
`int32`
|
<!-- source: ru/_includes/popup/id-changelog/region-ids.md -->
[Идентификаторы регионов](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-regions.md), для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, `1, 2`). Если значение не передано, задается значение `225` (Россия).
<!-- endsource: ru/_includes/popup/id-changelog/region-ids.md -->
||
|#

## Формат ответа {#response-format}

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "requestId": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a"
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <[requestId](*requestId)>c7fe80c0-36e3-11e6-8b2d-df96aa592c0a</requestId>
>   </Data>
>   ```
> 
> {% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
||
||
`requestId`
|
Да
|

`url`
|
<!-- source: ru/_includes/reference/feeds-add-start/requestId_desc.md -->
Идентификатор загрузки. Используйте его для отслеживания статуса с помощью метода [GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-add-info.md).
<!-- endsource: ru/_includes/reference/feeds-add-start/requestId_desc.md -->
||
|#


## Коды ответа {#errors}


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

#|

||
**Код**
|
**Причина**
|
**Описание**
||


||
200
|
OK
|
||

||
403
|
[FEEDS_LIMIT_EXCEEDED](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#feeds-limit-exceeded)
|
<!-- source: ru/_includes/reference/errors/dl-feeds-limit-exceeded.md -->
{% list tabs %}

- JSON

  
  ```json
  {
   "error_code": "FEEDS_LIMIT_EXCEEDED",
   "limit": 1,
   "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>FEEDS_LIMIT_EXCEEDED</error_code>
    <[limit](*limit_feed)>1</limit>
    <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-feeds-limit-exceeded.md -->
||


||
403
|
[INVALID_USER_ID](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id)
|
<!-- source: ru/_includes/reference/errors/code-inv-id.md -->
{% list tabs %}

- JSON

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

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>INVALID_USER_ID</error_code>
      <[available_user_id](*available_user_id)>1</available_user_id>
      <[error_message](*error_message)>Invalid user id. {user_id} should be used.</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/code-inv-id.md -->

||


||
403
|
[FEEDS_CATEGORY_BAN](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#feeds-category-ban)
|
<!-- source: ru/_includes/reference/errors/feeds-category-ban.md -->
{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "FEEDS_CATEGORY_BAN",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>FEEDS_CATEGORY_BAN</error_code>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/feeds-category-ban.md -->

||


||
404
|
[HOST_NOT_VERIFIED](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#host-not-verif)
|
Не подтверждены права на управление сайтом.

<!-- source: ru/_includes/reference/errors/dl-host-not-ver.md -->
{% list tabs %}

- JSON

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

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_NOT_VERIFIED</error_code>  
    <[host_id](*host_id)>http:ya.ru:80</host_id>
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-host-not-ver.md -->

||


||
404
|
[FEED_ALREADY_ADDED](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#feed-already-added)
|
<!-- source: ru/_includes/reference/errors/dl-feed-already-added.md -->
{% list tabs %}

- JSON

  
  ```javascript
  {
    "error_code": "FEED_ALREADY_ADDED",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>FEED_ALREADY_ADDED</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-feed-already-added.md -->

||


||
404
|
[ONLY_HTTPS](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#only-https)
|

<!-- source: ru/_includes/reference/errors/dl-only-https.md -->
{% list tabs %}

- JSON

  
  ```javascript
  {
    "error_code": "ONLY_HTTPS",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>ONLY_HTTPS</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-only-https.md -->

||


||
404
|
[INCORRECT_URL](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#incorrect-url)
|

<!-- source: ru/_includes/reference/errors/dl-incorrect-url.md -->
{% list tabs %}

- JSON

  
  ```javascript
  {
    "error_code": "INCORRECT_URL",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>INCORRECT_URL</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-incorrect-url.md -->

||


||
404
|
[WRONG_REGION](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#wrong-region)
|
<!-- source: ru/_includes/reference/errors/dl-wrong-region.md -->
{% list tabs %}

- JSON

  
  ```javascript
  {
    "error_code": "WRONG_REGION",
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>WRONG_REGION</error_code>  
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-wrong-region.md -->

||
|#

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

- [Коды ошибок и статусы](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md)






[*user-id]: Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.ru/dev/webmaster/doc/ru/reference/user.md).

[*host-id]: Тип: `string`. ID сайта. Чтобы получить его, используйте метод [GET&nbsp;/v4/user/{user&#x2011;id}/hosts](https://yandex.ru/dev/webmaster/doc/ru/reference/hosts.md).

[*url]: 
**Обязательный**

Да

**Тип**

`url`

**Описание**

<!-- source: ru/_includes/popup/id-changelog/feed-url.md -->
URL фида.
<!-- endsource: ru/_includes/popup/id-changelog/feed-url.md -->


<!-- source: ru/_includes/popup/id-changelog/feed-url2.md -->
Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: `https://yandex:WE9h4FfBml@example.com/feed.yml`.
<!-- endsource: ru/_includes/popup/id-changelog/feed-url2.md -->

[*requestId]: 
**Обязательный**

Да

**Тип**

`url`

**Описание**

<!-- source: ru/_includes/reference/feeds-add-start/requestId_desc.md -->
Идентификатор загрузки. Используйте его для отслеживания статуса с помощью метода [GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info/](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-add-info.md).
<!-- endsource: ru/_includes/reference/feeds-add-start/requestId_desc.md -->

[*type]: 
**Обязательный**

Да

**Тип**

`string`

**Описание**

<!-- source: ru/_includes/popup/id-changelog/feed-type.md -->
Категория бизнеса, для которого загружен фид. Возможные значения:
- `REALTY` — продажа или аренда квартир, офисов, домов и других построек;

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

- `GOODS` — продажа электроники, бытовой техники, строительных материалов, книг, запчастей и пр.;

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

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

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

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

- `ACTIVITY` — продажа билетов на развлекательные услуги.
<!-- endsource: ru/_includes/popup/id-changelog/feed-type.md -->

[*regionIds]: 
**Обязательный**

Нет

**Тип**

`int32`

**Описание**

<!-- source: ru/_includes/popup/id-changelog/region-ids.md -->
[Идентификаторы регионов](https://yandex.ru/dev/webmaster/doc/ru/reference/feeds-regions.md), для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, `1, 2`). Если значение не передано, задается значение `225` (Россия).
<!-- endsource: ru/_includes/popup/id-changelog/region-ids.md -->