---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://yandex.com/dev/webmaster/doc/en/reference/host-search-queries-history-all.md
  - https://yandex.com/dev/webmaster/doc/ru/reference/host-search-queries-history-all.md
  - href: ru/reference/host-search-queries-history-all.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
keywords: сайт
---
> **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-queries/all/history
  ? [[query_indicator](*query_indicator)=<string>]
  & [[device_type_indicator](*device_type_indicator)=<string>]
  & [[date_from](*date_from)=<datetime>]
  & [[date_to](*date_to)=<datetime>]
```


#|
||
`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 -->

||
||
`query_indicator`
|
<!-- source: ru/_includes/reference/host-search-queries-history-all/query_indicator.md -->
Индикаторы для отображения запросов ([ApiQueryIndicator](*query-indicators)). Можно указать несколько индикаторов. Например, 

```
query_indicator=
TOTAL_SHOWS&query_indicator=TOTAL_CLICKS
```
<!-- endsource: ru/_includes/reference/host-search-queries-history-all/query_indicator.md -->
||
||
`device_type_indicator`
|

<!-- source: ru/_includes/reference/host-search-queries-history-all/device_type_indicator.md -->
Тип устройства ([ApiDeviceTypeIndicator](*device-type-ind)). Значение по умолчанию: `ALL`.
<!-- endsource: ru/_includes/reference/host-search-queries-history-all/device_type_indicator.md -->


||
||
`date_from`
|

<!-- source: ru/_includes/popup/date_from2.md -->
Дата начала интервала. Если не указан, то данные возвращаются за последнюю неделю.
<!-- endsource: ru/_includes/popup/date_from2.md -->
||
||
`date_to`
|

<!-- source: ru/_includes/popup/date_to2.md -->
Дата конца интервала. Если не указан, то данные возвращаются за последнюю неделю.
<!-- endsource: ru/_includes/popup/date_to2.md -->

||
|#

<!-- source: ru/_includes/reference/errors/query-indicators.md -->
### Индикаторы запросов (ApiQueryIndicator) {#query-indicators}

#|
||
**Индикатор**
|
**Описание**
||
||
`TOTAL_SHOWS`
|
Количество показов.
||
||
`TOTAL_CLICKS`
|
Количество кликов.
||
||
`AVG_SHOW_POSITION`
|
Средняя позиция показа.
||
||
`AVG_CLICK_POSITION`
|
Средняя позиция клика.
||
|#
<!-- endsource: ru/_includes/reference/errors/query-indicators.md -->

<!-- source: ru/_includes/reference/errors/device-type.md -->
### Индикаторы типов устройств (ApiDeviceTypeIndicator) {#device-type}

#|
||
**Индикатор**
|
**Описание**
||
||
`ALL`
|
Все типы устройств.
||
||
`DESKTOP`
|
Компьютеры.
||
||
`MOBILE_AND_TABLET`
|
Мобильные телефоны и планшеты.
||
||
`MOBILE`
|
Мобильные телефоны.
||
||
`TABLET`
|
Планшеты.
||
|#


Если в запросе не задан индикатор типа устройства, по умолчанию используется значение `ALL`.
<!-- endsource: ru/_includes/reference/errors/device-type.md -->


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

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```javascript
>   {
>       "indicators": {
>           "[TOTAL_SHOWS](*query-indicators)": [
>               {
>                   "date": "2019-07-18T00:00:00.000+03:00",
>                   "value": 100.0
>               },
>               ...
>               }
>           ]
>       }
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <query>
>           <indicators>
>               <[TOTAL_SHOWS](*query-indicators)>
>                   <date>2019-07-18T00:00:00.000+03:00</date>
>                   <value>100.0</value>
>                   ...
>               </TOTAL_SHOWS>
>           </indicators>
>       </query>
>   </Data>
>   ```
> 
> {% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
|
**Примечание**
||
||
[TOTAL_SHOWS](#query-indicators)
|
Да
|
[ApiQueryIndicator](*query-indicators)
|
Показатель поискового запроса.
|
Может отсутствовать, если его значение не определено.
||
|#

<!-- source: ru/_includes/reference/errors/query-indicators.md -->
### Индикаторы запросов (ApiQueryIndicator) {#query-indicators}

#|
||
**Индикатор**
|
**Описание**
||
||
`TOTAL_SHOWS`
|
Количество показов.
||
||
`TOTAL_CLICKS`
|
Количество кликов.
||
||
`AVG_SHOW_POSITION`
|
Средняя позиция показа.
||
||
`AVG_CLICK_POSITION`
|
Средняя позиция клика.
||
|#
<!-- endsource: ru/_includes/reference/errors/query-indicators.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-токена.

{% 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>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>
  ```

{% 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>HOST_NOT_VERIFIED</error_code>  
    <host_id>http:ya.ru:80</host_id>
    <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>HOST_NOT_INDEXED</error_code>  
    <host_id>http:ya.ru:80</host_id>  
    <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>HOST_NOT_LOADED</error_code>  
    <host_id>http:ya.ru:80</host_id>
    <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).

[*device_type_indicator]: Тип устройства ([ApiDeviceTypeIndicator](*device-type-ind)). Значение по умолчанию: `ALL`.

[*date_from]: Дата начала интервала. Если не указан, то данные возвращаются за последнюю неделю.

[*date_to]: Дата конца интервала. Если не указан, то данные возвращаются за последнюю неделю.

[*query_indicator]: Индикаторы для отображения запросов ([ApiQueryIndicator](*query-indicators)). Можно указать несколько индикаторов. Например, 

```
query_indicator=
TOTAL_SHOWS&query_indicator=TOTAL_CLICKS
```

[*query-indicators]: 
### Индикаторы запросов (ApiQueryIndicator) {#query-indicators}

#|
||
**Индикатор**
|
**Описание**
||
||
`TOTAL_SHOWS`
|
Количество показов.
||
||
`TOTAL_CLICKS`
|
Количество кликов.
||
||
`AVG_SHOW_POSITION`
|
Средняя позиция показа.
||
||
`AVG_CLICK_POSITION`
|
Средняя позиция клика.
||
|#