---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.com/dev/webmaster/doc/en/reference/host-recrawl-task-get.md
  - https://yandex.com/dev/webmaster/doc/ru/reference/host-recrawl-task-get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/webmaster/doc/ru/llms.txt

# Проверка статуса задачи на переобход

Вовзращает статус задачи на переобход страницы сайта.

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

```
GET https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}/recrawl/queue/{[task-id](*task-id)}
```


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

||
||
`task-id`
|
<!-- source: ru/_includes/popup/task-id.md -->
Тип: `UUID`. ID задачи на переобход. Чтобы получить идентификатор, используйте метод [GET /v4/user/{user-id}/hosts/{host-id}/recrawl/queue](https://yandex.com/dev/webmaster/doc/ru/reference/host-recrawl-get.md).
<!-- endsource: ru/_includes/popup/task-id.md -->
||
|#

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

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "task_id": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a",
>     "url": "http://example.com/some/path?a=b",
>     "added_time": "2016-01-01T00:00:00,000+0300",
>     "state": "IN_PROGRESS"
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>     <[task_id](*task_id2)>c7fe80c0-36e3-11e6-8b2d-df96aa592c0a</task_id>
>     <[url](*url2)>http://example.com/some/path?a=b</url>
>     <[added_time](*added_time)>2016-01-01T00:00:00,000+0300</added_time>
>     <[state](*state2)>IN_PROGRESS</state>
>   </Data>
>   ```
> 
> {% endlist %}
> 
> #|
> || 
> **Имя**
> |
> **Обязательный**
> |
> **Тип**
> |
> **Описание**
> ||
> ||
> `task_id`
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/task_id/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/task_id/req.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/task_id/type.md -->
> `string`
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/task_id/type.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/task_id/desc.md -->
> ID задачи на переобход.
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/task_id/desc.md -->
> 
> ||
> ||
> `url`
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/url/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/url/req.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/url/type.md -->
> `string`
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/url/type.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/url/desc.md -->
> URL страницы, отправленной на переобход.
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/url/desc.md -->
> 
> ||
> ||
> `added_time`
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/added_time/req.md -->
> Нет
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/added_time/req.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/added_time/type.md -->
> `datetime`
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/added_time/type.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/added_time/desc.md -->
> Дата создания заявки на переобход.
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/added_time/desc.md -->
> 
> ||
> ||
> `state`
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/state/req.md -->
> Да
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/state/req.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/state/type.md -->
> `string` ([RecrawlStatusEnum](https://yandex.com/dev/webmaster/doc/ru/reference/host-recrawl-task-get.md#recrawl-status-enum))
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/state/type.md -->
> 
> |
> <!-- source: ru/_includes/reference/host-recrawl-task-get/state/desc.md -->
> Статус завяки на переобход.
> <!-- endsource: ru/_includes/reference/host-recrawl-task-get/state/desc.md -->
> 
> ||
> |#

<!-- source: ru/_includes/reference/errors/recrawl-status-enum.md -->
### Статусы заявки на переобход (RecrawlStatusEnum) {#recrawl-status-enum}

#|
||
**Индикатор**
|
**Описание**
||
||
`IN_PROGRESS`
|
Заявка обрабатывается.
||
||
`DONE`
|
Робот обошел URL.
||
||
`FAILED`
|
Робот не смог обойти страницу. [Проверьте](https://webmaster.yandex.ru/tools/server-response/), что она доступна для робота и сервер отвечает достаточно быстро.
||
|#
<!-- endsource: ru/_includes/reference/errors/recrawl-status-enum.md -->


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


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

#|
|| **Код** | **Причина** | **Описание** ||
|| 200 | OK | ||
|| 403 | [INVALID_USER_ID](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id) | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный `uid` владельца OAuth-токена.

<!-- 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 -->
||
|| 404 | [HOST_NOT_VERIFIED](https://yandex.com/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 | [TASK_NOT_FOUND](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#task-not-found) | Не найдена задача с указанным ID.

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

- JSON

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

- XML

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

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-task-not-found.md -->
||
|#


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

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






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

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

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/task_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/task_id/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-recrawl-task-get/task_id/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/task_id/type.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/task_id/desc.md -->
ID задачи на переобход.
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/task_id/desc.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/url/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/url/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-recrawl-task-get/url/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/url/type.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/url/desc.md -->
URL страницы, отправленной на переобход.
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/url/desc.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/added_time/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/added_time/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-recrawl-task-get/added_time/type.md -->
`datetime`
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/added_time/type.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/added_time/desc.md -->
Дата создания заявки на переобход.
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/added_time/desc.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/state/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/state/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-recrawl-task-get/state/type.md -->
`string` ([RecrawlStatusEnum](https://yandex.com/dev/webmaster/doc/ru/reference/host-recrawl-task-get.md#recrawl-status-enum))
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/state/type.md -->

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

<!-- source: ru/_includes/reference/host-recrawl-task-get/state/desc.md -->
Статус завяки на переобход.
<!-- endsource: ru/_includes/reference/host-recrawl-task-get/state/desc.md -->

[*task-id]: Тип: `UUID`. ID задачи на переобход. Чтобы получить идентификатор, используйте метод [GET /v4/user/{user-id}/hosts/{host-id}/recrawl/queue](https://yandex.com/dev/webmaster/doc/ru/reference/host-recrawl-get.md).