---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.com/dev/webmaster/doc/en/reference/hosts-indexing-insearch-history.md
  - https://yandex.com/dev/webmaster/doc/ru/reference/hosts-indexing-insearch-history.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)}/search-urls/in-search/history
 ? [[date_from](*date_from)=<datetime>]
 & [[date_to](*date_to)=<datetime>]
```

#|
|| `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).
 ||
|| `date_from` | Начало диапазона дат.
 ||
|| `date_to` | Конец диапазона дат.
 ||
|#

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

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>     "history": [
>       {
>         "date": "2016-01-01T00:00:00,000+0300",
>         "value": 1
>       }
>     ]
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>     <history>
>       <date>2016-01-01T00:00:00,000+0300</date>
>       <value>1</value>
>     </history>
>   </Data>
>   ```
> 
> {% endlist %}
> 
> #|
> || 
> **Имя**
> |
> **Обязательный**
> |
> **Тип**
> |
> **Описание**
> ||
> ||
> `date`
> |
> Да
> |
> `datetime`
> |
> Дата и время обновления поисковой выдачи.
> ||
> ||
> `value`
> |
> Да
> |
> `int64`
> |
> Количество страниц в поиске.
> ||
> |#

## Коды ответа {#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-токена.

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

{% 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 %}
 ||
|| 404 | [HOST_NOT_INDEXED](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-ind) | Сайт еще не проиндексирован.

{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "HOST_NOT_INDEXED", //errorCode. 
    "host_id": "http:ya.ru:80", //id хоста. host id. 
    "error_message": "some string" //Error message. 
  }
  ```
  

- XML

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

{% endlist %}
 ||
|| 404 | [HOST_NOT_LOADED](https://yandex.com/dev/webmaster/doc/ru/reference/errors.md#host-not-loaded) | Данные о сайте еще не загружены в Яндекс Вебмастер.

{% list tabs %}

- JSON

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

- XML

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

{% endlist %}
 ||
|#

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

- [Коды ошибок и статусы](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).

[*date_from]: Начало диапазона дат.

[*date_to]: Конец диапазона дат.