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


# Получение информации о популярных поисковых запросах

Позволяет получить список ТОП-3000 поисковых запросов, по которым сайт показывался на поиске за последнюю неделю. Можно выбрать 500 запросов с наибольшим числом показов или наибольшим числом кликов.

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

```
GET https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts/{[host-id](*host-id)}/search-queries/popular
  ? [order_by](*order_by_popup)=<string>
  & [[query_indicator](*query_indicator_popup)=<string>]
  & [[device_type_indicator](*device_type_indicator_popup)=<string>]
  & [[date_from](*date_from)=<datetime>]
  & [[date_to](*date_to)=<datetime>]
  & [[offset](*offset-param)=<int32>]
  & [[limit](*limit-param)=<int32>]
```

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

||
||
`order_by`[*](*requiredParam)
|

<!-- source: ru/_includes/reference/host-search-queries-popular/order_by.md -->
Показатель для сортировки запросов ([ApiQueryOrderField](*query-order)).
<!-- endsource: ru/_includes/reference/host-search-queries-popular/order_by.md -->

||
||
`query_indicator`
|

<!-- source: ru/_includes/reference/host-search-queries-popular/query_indicator.md -->
Индикаторы для отображения запросов ([ApiQueryIndicator](*query-indicators)).
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_indicator.md -->

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

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

||
||
`limit`
|

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

||
|#

* Обязательный параметр


<!-- source: ru/_includes/reference/errors/query-order.md -->
### Порядок сортировки запросов (ApiQueryOrderField) {#query-order}

#|
||
**Индикатор**
|
**Описание**
||
||
`TOTAL_SHOWS`
|
Количество показов.
||
||
`TOTAL_CLICKS`
|
Количество кликов.
||
|#
<!-- endsource: ru/_includes/reference/errors/query-order.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
>   {
>     "queries": [
>       {
>         "query_id": "a08b",
>         "query_text": "some text",
>         "indicators": {
>           "[TOTAL_SHOWS](*query-indicators)": 1.1, ...
>         }
>       }, ...
>     ],
>     "date_from": "2016-01-01",
>     "date_to": "2016-01-07",
>     "count": "300"
>   }
>   ```
>   
> 
> - XML
> 
>   
>   ```xml
>   <Data>
>       <query>
>           <[query_id](*query_id)>a08b</query_id>
>           <[query_text](*query_text)>some text</query_text>
>           <indicators>
>               <[TOTAL_SHOWS](*query-indicators)>1.1</TOTAL_SHOWS>
>               ...
>           </indicators>
>       </query>
>       ...
>       <[date_from](*date_from)>2016-01-01</date_from>
>       <[date_to](*date_to)>2016-01-07</date_to>
>       <[count](*count)>300</count>
>   </Data>
>   ```
> 
> {% endlist %}

#|
||
**Имя**
|
**Обязательный**
|
**Тип**
|
**Описание**
|
**Примечание**
||
||
`query_id`
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/req.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/type.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/desc.md -->
ID поискового запроса.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/desc.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/note.md -->
—
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/note.md -->
||
||
`query_text`
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/req.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/type.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/desc.md -->
Текст поискового запроса.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/desc.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/note.md -->
—
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/note.md -->
||
||
[TOTAL_SHOWS](*query-indicators)
|
Да
|
[ApiQueryIndicator](*query-indicators)
|
Показатель поискового запроса.
|
Может отсутствовать, если его значение не определено.
||
||
`date_from`
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_from/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_from/req.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_from/type.md -->
`datetime`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_from/type.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_from/desc.md -->
Дата начала интервала.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_from/desc.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_from/note.md -->
Может отличаться в **большую** сторону от заданного вами значения в запросе, если более ранних данных для сайта нет.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_from/note.md -->
||
||
`date_to`
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_to/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_to/req.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_to/type.md -->
`datetime`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_to/type.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_to/desc.md -->
Дата конца интервала.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_to/desc.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/date_to/note.md -->
Может отличаться в **меньшую** сторону от заданного вами значения в запросе, если более ранних данных для сайта нет.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/date_to/note.md -->
||
||
`count`
|
<!-- source: ru/_includes/reference/host-search-queries-popular/count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/req.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/count/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/type.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/count/desc.md -->
Общее количество доступных поисковых запросов.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/desc.md -->
|
<!-- source: ru/_includes/reference/host-search-queries-popular/count/note.md -->
—
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/note.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 -->


## Коды ответа {#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 | [HOST_NOT_INDEXED](https://yandex.com/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.com/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 -->
||
|#

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

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






[*order_by_popup]: Показатель для сортировки запросов ([ApiQueryOrderField](#query-order)).

[*query_indicator_popup]: Индикаторы для отображения запросов ([ApiQueryIndicator](#query-indicators)).

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

[*offset-param]: Смещение списка. Минимальное значение — 0. Значение по умолчанию: 0.

[*limit-param]: Количество записей (1—500). Значение по умолчанию: 500.

[*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).

[*requiredParam]: \*  Обязательный параметр

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

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

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

<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/type.md -->

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

<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/desc.md -->
ID поискового запроса.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/desc.md -->

**Примечание**

<!-- source: ru/_includes/reference/host-search-queries-popular/query_id/note.md -->
—
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_id/note.md -->

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

<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/type.md -->
`string`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/type.md -->

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

<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/desc.md -->
Текст поискового запроса.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/desc.md -->

**Примечание**

<!-- source: ru/_includes/reference/host-search-queries-popular/query_text/note.md -->
—
<!-- endsource: ru/_includes/reference/host-search-queries-popular/query_text/note.md -->

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

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

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

<!-- source: ru/_includes/reference/host-search-queries-popular/count/req.md -->
Да
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/req.md -->

**Тип**

<!-- source: ru/_includes/reference/host-search-queries-popular/count/type.md -->
`int32`
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/type.md -->

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

<!-- source: ru/_includes/reference/host-search-queries-popular/count/desc.md -->
Общее количество доступных поисковых запросов.
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/desc.md -->

**Примечание**

<!-- source: ru/_includes/reference/host-search-queries-popular/count/note.md -->
—
<!-- endsource: ru/_includes/reference/host-search-queries-popular/count/note.md -->