---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md
keywords:
  - с
  - а
  - й
  - т
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/ru/llms.txt


# Мониторинг поисковых запросов

Позволяет получить список поисковых запросов и URL-адресов страниц, по которым ваш сайт отображается в результатах поиска Яндекса. Данные доступны за последние две недели. Подробно о мониторинге поисковых запросов см. [в Справке](https://yandex.ru/support/webmaster/service/popular-queries.html).

{% note info %}

Если вы отправите более 10 тысяч запросов в час, вы не сможете воспользоваться мониторингом в течение некоторого времени. Сообщение о превышении появится в [коде ответа 429](#errors).

{% endnote %}

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

```
POST https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}/query-analytics/list
```

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

||
|#

### Заголовок запроса

При отправке запроса используйте заголовок `Content-Type: application/json; charset=UTF-8`.

### Формат тела запроса


{% list tabs %}

- JSON

  
  ```json
  {
    "offset": 1,
    "limit": 1,
    "device_type_indicator": "ALL",
    "search_location": "WEB_LOCATION",
    "text_indicator": "URL",
    "region_ids": [
      1
    ],
    "filters": {
      "text_filters": [
        {
          "text_indicator": "URL",
          "operation": "TEXT_CONTAINS",
          "value": "some string"
        }
      ],
      "statistic_filters": [
        {
          "statistic_field": "IMPRESSIONS",
          "operation": "LESS_THAN",
          "value": "some string",
          "from": "some string",
          "to": "some string"
        }
      ]
    },
    "sort_by_date": {
      "date": "some string",
      "statistic_field": "IMPRESSIONS",
      "by": "ASC"
    }
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[offset](*offset2)>1</offset>
    <[limit](*limit2)>1</limit>
    <[device_type_indicator](*device_type_indicator)>ALL</device_type_indicator>
    <[search_location](*search_location)>WEB_LOCATION</search_location>
    <[text_indicator](*text_indicator)>URL</text_indicator>
    <region_id>1</region_id>
  
    <filters>
      <text_filter>
        <[text_indicator](*text_indicator2)>URL</text_indicator>
        <[operation](*operation)>TEXT_CONTAINS</operation>
        <[value](*value)>some string</value>
      </text_filter>
  
      <statistic_filter>
        <[statistic_field](*statistic_field)>IMPRESSIONS</statistic_field>
        <[operation](*operation2)>LESS_THAN</operation>
        <[value](*value2)>some string</value>
        <[from](*from)>some string</from>
        <[to](*to)>some string</to>
      </statistic_filter>
    </filters>
  
    <sort_by_date>
      <[date](*date)>some string</date>
      <[statistic_field](*statistic_field)>IMPRESSIONS</statistic_field>
      <[by](*by)>ASC</by>
    </sort_by_date>
  </Data>
  ```

{% endlist %}

#|
||
**Имя**
|
**Обязательно**
|
**Тип**
|
**Описание**
||
||
`offset`
|
<!-- source: ru/_includes/reference/host-query-analytics/offset/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/offset/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/offset/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-query-analytics/offset/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/offset/desc.md -->
Смещение списка. Минимальное значение — 0. Значение по умолчанию: 0.
<!-- endsource: ru/_includes/reference/host-query-analytics/offset/desc.md -->

||
||
`limit`
|
<!-- source: ru/_includes/reference/host-query-analytics/limit/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/limit/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/limit/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-query-analytics/limit/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/limit/desc.md -->
Количество записей (1—500). Значение по умолчанию: 20.
<!-- endsource: ru/_includes/reference/host-query-analytics/limit/desc.md -->
||
||
`device_type_indicator`
|
<!-- source: ru/_includes/reference/host-query-analytics/device_type_indicator/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/device_type_indicator/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/device_type_indicator/type.md -->
[ApiDeviceTypeIndicator](*device-type)
<!-- endsource: ru/_includes/reference/host-query-analytics/device_type_indicator/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/device_type_indicator/desc.md -->
Тип устройства. Значение по умолчанию: `ALL`.
<!-- endsource: ru/_includes/reference/host-query-analytics/device_type_indicator/desc.md -->
||
||
`search_location`
|
<!-- source: ru/_includes/reference/host-query-analytics/search_location/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/search_location/req.md --> 
|
<!-- source: ru/_includes/reference/host-query-analytics/search_location/type.md -->
[ApiSearchLocationIndicator](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#search_location)
<!-- endsource: ru/_includes/reference/host-query-analytics/search_location/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/search_location/desc.md -->
Тип размещения.
Значение по умолчанию: `WEB_LOCATION`.
<!-- endsource: ru/_includes/reference/host-query-analytics/search_location/desc.md -->
||
||
`text_indicator`
|
<!-- source: ru/_includes/reference/host-query-analytics/text_indicator/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/text_indicator/type.md -->
`Indicator`
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/text_indicator/desc.md -->
Тип данных, по которому отображается статистика. По умолчанию принимает значение `QUERY`. Возможные значения:

- `QUERY` — поисковый запрос;

- `URL` — адрес страницы сайта.
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator/desc.md -->

||
||
`region_ids`
|

|
`array`
|
[Идентификаторы регионов](#region-ids), для которых производится мониторинг. Можно указать несколько идентификатор через запятую (например, `1, 2`). Если значение не задано, статистика считается по всем регионам, в которых присутствует сайт в результатах поиска.
||
||
`filters`
|
Нет
|
`Filters`
|
Фильтры.
||
||
`sort_by_date`
|
Нет
|
`SortByDate`
|
Сортировка данных по дате.
||
||
**Поля внутри Filters**
||
||
`text_filters`
|
Нет
|
`array (TextFilter)`
|
Фильтры над текстом.
||
||
`statistic_filters`
|
Нет
|
`array (StatisticFilter)`
|
Фильтры над статистическими данными.
||
||

**Поля внутри TextFilters**
||
||
`text_indicator`
|
<!-- source: ru/_includes/reference/host-query-analytics/text_indicator2/req.md -->
Да, если передается `TextFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator2/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/text_indicator2/type.md -->
`Indicator`
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator2/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/text_indicator2/desc.md -->
Тип данных, по которому отображается статистика. Возможные значения:

- `QUERY` — поисковый запрос;

- `URL` — адрес страницы сайта.
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator2/desc.md -->
||
||
`operation`
|
^ 
|
<!-- source: ru/_includes/reference/host-query-analytics/operation/type.md -->
[ApiTextualOperation](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#textual-operation)
<!-- endsource: ru/_includes/reference/host-query-analytics/operation/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/operation/desc.md -->
Операции с URL или текстом запроса.
<!-- endsource: ru/_includes/reference/host-query-analytics/operation/desc.md -->
||
||
`value`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/value/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-query-analytics/value/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/value/desc.md -->
Строка, к которой применяется операция. Используется для фильтрации поискового запроса или URL. Например, фрагмент «brand».
<!-- endsource: ru/_includes/reference/host-query-analytics/value/desc.md -->
||
||

**Поля внутри StatisticFilters**
||
||
`statistic_field`
|
<!-- source: ru/_includes/reference/host-query-analytics/statistic_field/req.md -->
Да, если передается `StatisticFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/statistic_field/type.md -->
[ApiStatisticField](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#statistic-field)
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/statistic_field/desc.md -->
Статистические данные, над которыми производится фильтрация.
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field/desc.md -->
||
||
`operation`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/operation2/type.md -->
[ApiNumericOperation](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#numeric-operation)
<!-- endsource: ru/_includes/reference/host-query-analytics/operation2/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/operation2/desc.md -->
Целое число, которое применяется к операции.
<!-- endsource: ru/_includes/reference/host-query-analytics/operation2/desc.md -->
||
||
`value`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/value2/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-query-analytics/value2/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/value2/desc.md -->
Число, с которым нужно сравнить статистическое значение.
<!-- endsource: ru/_includes/reference/host-query-analytics/value2/desc.md -->
||
||
`from`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/from/type.md -->
—
<!-- endsource: ru/_includes/reference/host-query-analytics/from/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/from/desc.md -->
Начало (включительно) интервала дат в формате yyyy-MM-dd.
<!-- endsource: ru/_includes/reference/host-query-analytics/from/desc.md -->
||
||
`to`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/to/type.md -->
—
<!-- endsource: ru/_includes/reference/host-query-analytics/to/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/to/desc.md -->
Конец (включительно) интервала дат в формате yyyy-MM-dd.
<!-- endsource: ru/_includes/reference/host-query-analytics/to/desc.md -->
||
||

**Поля внутри SortByDate**
||
||
`date`
|
<!-- source: ru/_includes/reference/host-query-analytics/date/req.md -->
Да, если передается `SortByDate`
<!-- endsource: ru/_includes/reference/host-query-analytics/date/req.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/date/type.md -->
—
<!-- endsource: ru/_includes/reference/host-query-analytics/date/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/date/desc.md -->
Дата в формате yyyy-MM-dd.
<!-- endsource: ru/_includes/reference/host-query-analytics/date/desc.md -->
||
||
`statistic_field`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/statistic_field2/type.md -->
[ApiStatisticField](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#statistic-field)
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field2/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/statistic_field2/desc.md -->
Статистические данные, над которыми производится фильтрация.
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field2/desc.md -->
||
||
`by`
|
^
|
<!-- source: ru/_includes/reference/host-query-analytics/by/type.md -->
[OrderDirection](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#order-direction)
<!-- endsource: ru/_includes/reference/host-query-analytics/by/type.md -->
|
<!-- source: ru/_includes/reference/host-query-analytics/by/desc.md -->
Тип для описания направления сортировки.
<!-- endsource: ru/_includes/reference/host-query-analytics/by/desc.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 -->

<!-- source: ru/_includes/reference/errors/search_location.md -->
### Статистические данные, над которыми производится фильтрация (ApiSearchLocationIndicator) {#search_location}

#|
||
**Индикатор**
|
**Описание**
||
||
`ALL_LOCATIONS`
|
«Все вместе» — общее количество показов страниц, которые отобраны поисковым ранжированием в топ выдачи. Сумма типов размещения «Органическая выдача» и «Динамические места».
||
||
`ALL_LOCATIONS_ORGANIC`
|
«Все вместе без дополнительных кликов» – показы страниц, которые отобраны поисковым ранжированием в топ выдачи, без учета дополнительных кликов «Динамических мест».
||
||
`WEB_LOCATION`
|
«Органическая выдача» – стандартные показы сниппетов в результатах поисковой выдачи.
||
||
`DYNAMIC_LOCATION_ALL`
|
«Динамические места на Поиске» – дополнительные места в выдаче, на которых могут показаться объявления из Директа. Дают возможность получать дополнительные клики и конверсии за счет повышения видимости страницы.

Показ складывается из результатов оптимизации страницы и ее успешного участия в аукционе Директа. Подробнее – в [Справке Директа](https://yandex.ru/support/direct/ru/general/dynamic-places).
||
||
`DYNAMIC_LOCATION_BASIC`
|
«Показы базовых кликов» – показы на динамических местах, которые были определены как ведущие к [базовым кликам](*basic_clicks). Подробнее – в [Справке Директа](https://yandex.ru/support/direct/ru/general/dynamic-places).
||
||
`DYNAMIC_LOCATION_ADDITIONAL`
|
«Показы дополнительных кликов» – показы на динамических местах, которые были определены как ведущие к [дополнительным кликам](*additional_clicks). Подробнее – в [Справке Директа](https://yandex.ru/support/direct/ru/general/dynamic-places).
||
|#

{% cut "Оценить результат типа размещения" %}

- Чтобы оценить общее количество показов страницы в органической выдаче, используйте фильтр «Все вместе» (`ALL_LOCATIONS`). Также с этим фильтром можно оценить динамику средней позиции показа.

- Чтобы оценить, какая часть показов и кликов произошла на более заметных динамических местах, используйте фильтр «Динамические места» (`DYNAMIC_LOCATION_ALL`).

- Чтобы оценить, какая часть кликов на динамических местах была базовой, а какая – дополнительной (и, соответственно, оплачиваемой) – используйте фильтр «Показы базовых кликов» (`DYNAMIC_LOCATION_BASIC`) или «Показы дополнительных кликов» (`DYNAMIC_LOCATION_ADDITIONAL`).

{% endcut %}
<!-- endsource: ru/_includes/reference/errors/search_location.md -->

<!-- source: ru/_includes/reference/errors/textual-operation.md -->
### Операции с текстом запроса (ApiTextualOperation) {#textual-operation}

#|
||
**Индикатор**
|
**Описание**
||
||
`TEXT_CONTAINS`
|
Укажите часть текста.
||
||
`TEXT_MATCH`
|
Укажите полностью поисковый запрос.
||
||
`TEXT_DOES_NOT_CONTAIN`
|
Укажите часть текста, который не должен входить в поисковый запрос.
||
|#
<!-- endsource: ru/_includes/reference/errors/textual-operation.md -->

<!-- source: ru/_includes/reference/errors/statistic-field.md -->
### Статистические данные, над которыми производится фильтрация (ApiStatisticField) {#statistic-field}

#|
||
**Индикатор**
|
**Описание**
||
||
`IMPRESSIONS`
|
Появление ссылки на сайт в результатах поиска Яндекса по некоторому запросу. Показом не является потенциальное появление ссылки на второй и последующих страницах результатов поиска, если пользователь эти страницы не открывал.
||
||
`POSITION`
|
Место, на котором появляется ссылка на сайт в поисковой выдаче Яндекса в ответ на поисковый запрос пользователя.

Информация о позиции сайта может отсутствовать, если в заданный период:
- сайт не отображался в результатах поиска по указанному поисковому запросу;
- пользователи не вводили указанный поисковый запрос;
- пользователи не долистали до позиции сайта в результатах поиска.

В этом случае обратите внимание на «Спрос» (`DEMAND`). Например, если он равен 0, значит пользователи не задавали поисковый запрос. Если значение больше 0, но позиция не определена, вероятно, пользователи не долистали до позиции сайта или сайта нет в результатах поиска по поисковому запросу.
||
||
`CLICKS`
|
Переход посетителя на сайт со страницы результатов поиска Яндекса.
||
||
`CTR`
|
Отношение числа кликов на сниппет к числу его показов, измеряется в процентах. Можно сказать, что этот показатель говорит о привлекательности сниппета страницы сайта.
||
||
`DEMAND`
|
Спрос показывает, насколько часто пользователи Яндекса задают поисковый запрос. Если сайт отображается на первой странице больше одного раза, сумма показов сайта может оказаться больше спроса. Например, для навигационных запросов, где пользователь ищет конкретный сайт, и поисковая система показывает несколько результатов с одного сайта.
||
|#
<!-- endsource: ru/_includes/reference/errors/statistic-field.md -->

<!-- source: ru/_includes/reference/errors/numeric-operation.md -->
### Целое число, которое применяется к операции (ApiNumericOperation) {#numeric-operation}

#|
||
**Индикатор**
|
**Описание**
||
||
`LESS_THAN`
|
Меньше чем.
||
||
`GREATER_THAN`
|
Больше чем.
||
||
`LESS_EQUAL`
|
Меньше или равно.
||
||
`GREATER_EQUAL`
|
Больше или равно.
||
||
`EQUAL`
|
Равно.
||
|#
<!-- endsource: ru/_includes/reference/errors/numeric-operation.md -->

<!-- source: ru/_includes/reference/errors/order-direction.md -->
### Тип для описания направления сортировки (OrderDirection) {#order-direction}

#|
||
**Индикатор**
|
**Описание**
||
||
`ASC`
|
По возрастанию.
||
||
`DESC`
|
По убыванию.
||
|#
<!-- endsource: ru/_includes/reference/errors/order-direction.md -->


### Идентификаторы часто используемых регионов {#region-ids}


#|
||
**Идентификатор**
|
**Регион**
||
||
225
|
Россия
||
||
11235
|
Алтайский край
||
||
11375
|
Амурская область
||
||
10842
|
Архангельская область
||
||
10946
|
Астраханская область
||
||
10645
|
Белгородская область
||
||
10650
|
Брянская область
||
||
10658
|
Владимирская область
||
||
10950
|
Волгоградская область
||
||
10853
|
Вологодская область
||
||
10672
|
Воронежская область
||
||
10687
|
Ивановская область
||
||
11266
|
Иркутская область
||
||
11013
|
Кабардино-Балкарская Республика
||
||
10857
|
Калининградская область
||
||
11020
|
Карачаево-Черкесская Республика
||
||
11282
|
Кемеровская область (Кузбасс)
||
||
10699
|
Костромская область
||
||
10995
|
Краснодарский край
||
||
11309
|
Красноярский край
||
||
11158
|
Курганская область
||
||
10705
|
Курская область
||
||
10712
|
Липецкая область
||
||
1
|
Москва и Московская область
||
||
10897
|
Мурманская область
||
||
11079
|
Нижегородская область
||
||
10904
|
Новгородская область
||
||
11316
|
Новосибирская область
||
||
11318
|
Омская область
||
||
11084
|
Оренбургская область
||
||
10772
|
Орловская область
||
||
11095
|
Пензенская область
||
||
11108
|
Пермский край
||
||
11409
|
Приморский край
||
||
10926
|
Псковская область
||
||
11111
|
Республика Башкортостан
||
||
11010
|
Республика Дагестан
||
||
11012
|
Республика Ингушетия
||
||
11077
|
Республика Марий Эл
||
||
11117
|
Республика Мордовия
||
||
11021
|
Республика Северная Осетия — Алания
||
||
11119
|
Республика Татарстан
||
||
11029
|
Ростовская область
||
||
10776
|
Рязанская область
||
||
11131
|
Самарская область
||
||
10174
|
Санкт-Петербург и Ленинградская область
||
||
11162
|
Свердловская область
||
||
10795
|
Смоленская область
||
||
11069
|
Ставропольский край
||
||
10802
|
Тамбовская область
||
||
10819
|
Тверская область
||
||
11353
|
Томская область
||
||
10832
|
Тульская область
||
||
11153
|
Ульяновская область
||
||
11457
|
Хабаровский край
||
||
11193
|
Ханты-Мансийский автономный округ - Югра
||
||
11225
|
Челябинская область
||
||
11024
|
Чеченская Республика
||
||
11156
|
Чувашская Республика
||
||
10841
|
Ярославская область
||
|#



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

### Примеры
> 
> 
> {% list tabs %}
> 
> - JSON
> 
>   
>   ```json
>   {
>       "count": 5175,
>       "text_indicator_to_statistics": [
>           {
>               "text_indicator": {
>                   "type": "URL",
>                   "value": "some text"
>               },
>               "popular_complementary_indicator": {
>                   "type": "QUERY",
>                   "value": "some text"
>               },
>               "statistics": [
>                   {
>                       "date": "2023-04-15",
>                       "field": "CLICKS",
>                       "value": 7.0
>                   },
>                   {
>                       "date": "2023-04-15",
>                       "field": "POSITION",
>                       "value": 4.0
>                   },
>                   {
>                       "date": "2023-04-15",
>                       "field": "IMPRESSIONS",
>                       "value": 8595.0
>                   },
>                   {
>                       "date": "2023-04-15",
>                       "field": "CTR",
>                       "value": 0.0
>                   },
>               ...                
>   ```
>  
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <count>5175</count>
>       <text_indicator_to_statistic>
>           <text_indicator>
>               <type>URL</type>
>               <value>some text</value>
>           </text_indicator>
>           <popular_complementary_indicator>
>               <type>QUERY</type>
>               <value>some text</value>
>           </popular_complementary_indicator>
>           <statistic>
>               <date>2023-04-15</date>
>               <field>CLICKS</field>
>               <value>7.0</value>
>           </statistic>
>           <statistic>
>               <date>2023-04-15</date>
>               <field>POSITION</field>
>               <value>4.0</value>
>           </statistic>
>           <statistic>
>               <date>2023-04-15</date>
>               <field>IMPRESSIONS</field>
>               <value>8595.0</value>
>           </statistic>
>           ...    
>   ```
> 
> {% endlist %}
>

#|
|| **Имя** | **Обязательный** | **Тип** | **Описание** ||
|| `count` | Да | `int32` | Общее количество доступных данных. ||
|| `text_indicator_to_statistics` | Да | `array`
`(TextIndicatorToStatistics)` | ||
|| **Поля внутри TextIndicatorToStatistics** ||
|| `text_indicator ` | Да | `TextIndicator` ||
|| `popular_complementary_indicator ` | Да | `PopularComplementaryIndicator` ||
||`statistics` | Да | `array (Statistics)` ||
|| **Поля внутри TextIndicator** ||
|| `type` | Да | `string` |
Возможные значения:

- `QUERY` — поисковый запрос;

- `URL` — адрес страницы сайта.
||
|| `value` | Да | `string` | Поисковый запрос или URL страницы сайта. ||
|| **Поля внутри PopularComplementaryIndicator** ||
|| `type` | Да | `string` |
Возможные значения:

- `QUERY` — поисковый запрос;

- `URL` — адрес страницы сайта.
||
|| `value` | Да | `string` | Cамый высокочастотный поисковый запрос для адреса страницы сайта / адрес страницы сайта для поискового запроса из `text_indicator`. ||
|| **Поля внутри Statistics** ||
|| `date` | Да | — | Дата в формате yyyy-MM-dd, за которую отображается статистика. ||
|| `field` | Да | [ApiStatisticField](#statistic-field) | Тип показателя. ||
|| `value` | Да | `double` | Значение показателя. ||
|#

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

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

#|
|| **Код** | **Причина** | **Описание** ||
|| 200 | OK ||
|| 400 | [ENTITY_VALIDATION_ERROR](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#400) | Тело запроса не прошло валидацию.

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

- JSON

  
  ```json
  {
    "error_code": "ENTITY_VALIDATION_ERROR",
    "error_message": "some string"
  }
  ```
  

- XML

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

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-entity-val.md -->
||
|| 400 | [FIELD_VALIDATION_ERROR](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#field-valid) | Передан неверный параметр.

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

- JSON

  
  ```json
  {
    "error_code": "FIELD_VALIDATION_ERROR",
    "error_message": "explicit error message",
    "field_name": "some string",
    "field_value": "some string",
    "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>FIELD_VALIDATION_ERROR</error_code>
      <[field_name](*field_name)>some string</field_name>
      <[field_value](*field_value)>some string</field_value>
      <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-field-val.md -->
||
|| 400 | [INVALID_URL](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#inv-url) | Передан неправильный URL.

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

- JSON

  
  ```json
  {
    "error_code": "INVALID_URL",
    "error_message": "some string"
  }
  ```
  

- XML

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

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-inv-url.md -->
||
|| 403 | [INVALID_USER_ID](https://yandex.ru/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.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 | [HOST_NOT_INDEXED](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#host-not-ind) | Сайт не проиндексирован.

<!-- source: ru/_includes/reference/errors/dl-host-not-ind.md -->
{% 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 %}
<!-- endsource: ru/_includes/reference/errors/dl-host-not-ind.md -->

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

<!-- source: ru/_includes/reference/errors/dl-host-not-loaded.md -->
{% 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 %}
<!-- endsource: ru/_includes/reference/errors/dl-host-not-loaded.md -->
||
|| 429 | [TOO_MANY_REQUESTS_ERROR](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#too-many-req) | Отправлено более 10 тысяч запросов на домен в час. Поэтому вы не сможете использовать метод [/user/{user-id}/hosts/{host-id}/query-analytics/list/](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md) в течение некоторого времени.

<!-- source: ru/_includes/reference/errors/dl-too-many-req.md -->
{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "TOO_MANY_REQUESTS_ERROR",
    "error_message": "some string"
  }
  ```
  

- XML

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

{% endlist %}
<!-- endsource: ru/_includes/reference/errors/dl-too-many-req.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).

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

<!-- source: ru/_includes/reference/host-query-analytics/offset/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/offset/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/offset/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-query-analytics/offset/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/offset/desc.md -->
Смещение списка. Минимальное значение — 0. Значение по умолчанию: 0.
<!-- endsource: ru/_includes/reference/host-query-analytics/offset/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/limit/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/limit/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/limit/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-query-analytics/limit/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/limit/desc.md -->
Количество записей (1—500). Значение по умолчанию: 20.
<!-- endsource: ru/_includes/reference/host-query-analytics/limit/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/device_type_indicator/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/device_type_indicator/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/device_type_indicator/type.md -->
[ApiDeviceTypeIndicator](*device-type)
<!-- endsource: ru/_includes/reference/host-query-analytics/device_type_indicator/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/device_type_indicator/desc.md -->
Тип устройства. Значение по умолчанию: `ALL`.
<!-- endsource: ru/_includes/reference/host-query-analytics/device_type_indicator/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/search_location/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/search_location/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/search_location/type.md -->
[ApiSearchLocationIndicator](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#search_location)
<!-- endsource: ru/_includes/reference/host-query-analytics/search_location/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/search_location/desc.md -->
Тип размещения.
Значение по умолчанию: `WEB_LOCATION`.
<!-- endsource: ru/_includes/reference/host-query-analytics/search_location/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/text_indicator/req.md -->
Нет
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/text_indicator/type.md -->
`Indicator`
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/text_indicator/desc.md -->
Тип данных, по которому отображается статистика. По умолчанию принимает значение `QUERY`. Возможные значения:

- `QUERY` — поисковый запрос;

- `URL` — адрес страницы сайта.
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/text_indicator2/req.md -->
Да, если передается `TextFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator2/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/text_indicator2/type.md -->
`Indicator`
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator2/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/text_indicator2/desc.md -->
Тип данных, по которому отображается статистика. Возможные значения:

- `QUERY` — поисковый запрос;

- `URL` — адрес страницы сайта.
<!-- endsource: ru/_includes/reference/host-query-analytics/text_indicator2/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/operation/req.md -->
Да, если передается `TextFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/operation/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/operation/type.md -->
[ApiTextualOperation](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#textual-operation)
<!-- endsource: ru/_includes/reference/host-query-analytics/operation/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/operation/desc.md -->
Операции с URL или текстом запроса.
<!-- endsource: ru/_includes/reference/host-query-analytics/operation/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/operation2/req.md -->
Да, если передается `StatisticFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/operation2/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/operation2/type.md -->
[ApiNumericOperation](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#numeric-operation)
<!-- endsource: ru/_includes/reference/host-query-analytics/operation2/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/operation2/desc.md -->
Целое число, которое применяется к операции.
<!-- endsource: ru/_includes/reference/host-query-analytics/operation2/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/by/req.md -->
Да, если передается `SortByDate`
<!-- endsource: ru/_includes/reference/host-query-analytics/by/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/by/type.md -->
[OrderDirection](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#order-direction)
<!-- endsource: ru/_includes/reference/host-query-analytics/by/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/by/desc.md -->
Тип для описания направления сортировки.
<!-- endsource: ru/_includes/reference/host-query-analytics/by/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/from/req.md -->
Да, если передается `StatisticFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/from/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/from/type.md -->
—
<!-- endsource: ru/_includes/reference/host-query-analytics/from/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/from/desc.md -->
Начало (включительно) интервала дат в формате yyyy-MM-dd.
<!-- endsource: ru/_includes/reference/host-query-analytics/from/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/date/req.md -->
Да, если передается `SortByDate`
<!-- endsource: ru/_includes/reference/host-query-analytics/date/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/date/type.md -->
—
<!-- endsource: ru/_includes/reference/host-query-analytics/date/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/date/desc.md -->
Дата в формате yyyy-MM-dd.
<!-- endsource: ru/_includes/reference/host-query-analytics/date/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/to/req.md -->
Да, если передается `StatisticFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/to/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/to/type.md -->
—
<!-- endsource: ru/_includes/reference/host-query-analytics/to/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/to/desc.md -->
Конец (включительно) интервала дат в формате yyyy-MM-dd.
<!-- endsource: ru/_includes/reference/host-query-analytics/to/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/value/req.md -->
Да, если передается `TextFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/value/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/value/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-query-analytics/value/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/value/desc.md -->
Строка, к которой применяется операция. Используется для фильтрации поискового запроса или URL. Например, фрагмент «brand».
<!-- endsource: ru/_includes/reference/host-query-analytics/value/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/value2/req.md -->
Да, если передается `StatisticFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/value2/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/value2/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-query-analytics/value2/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/value2/desc.md -->
Число, с которым нужно сравнить статистическое значение.
<!-- endsource: ru/_includes/reference/host-query-analytics/value2/desc.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/statistic_field/req.md -->
Да, если передается `StatisticFilters`
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-query-analytics/statistic_field/type.md -->
[ApiStatisticField](https://yandex.ru/dev/webmaster/doc/ru/reference/host-query-analytics.md#statistic-field)
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field/type.md -->

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

<!-- source: ru/_includes/reference/host-query-analytics/statistic_field/desc.md -->
Статистические данные, над которыми производится фильтрация.
<!-- endsource: ru/_includes/reference/host-query-analytics/statistic_field/desc.md -->

[*basic_clicks]: Клики, которые страница получила бы с органического размещения и без динамического места.

[*additional_clicks]: Клики, которые произошли в результате размещения на динамических местах.