---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/keywordsresearch/hasSearchVolume.md
  - https://yandex.com/dev/direct/doc/ru/keywordsresearch/hasSearchVolume.md
  - href: ru/keywordsresearch/hasSearchVolume.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/keywordsresearch/hasSearchVolume.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# hasSearchVolume

Для заданных ключевых фраз и регионов формирует предварительный прогноз наличия показов по этим фразам в разбивке по типам устройств. Используется при подборе ключевых фраз.

## Ограничения {#restrictions}

В течение 60-секундного интервала можно отправить не более 20 запросов для одного рекламодателя.


## Запрос {#input}

Структура запроса в формате JSON:

```javascript translate=no
{
  "method": "hasSearchVolume",
  "params": { /* params */
    "SelectionCriteria": {  /* HasSearchVolumeSelectionCriteria */
      "Keywords": [(string), ... ], /* required */
      "RegionIds": [(long), ... ] /* required */
    }, /* required */
    "FieldNames": [( "Keyword" | "RegionIds" | "AllDevices" | "MobilePhones" | "Tablets" | "Desktops" ), ... ] /* required */
  } 
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
**Структура params (для JSON) / HasSearchVolumeRequest (для SOAP)**
||
||
`SelectionCriteria`
|
HasSearchVolumeSelectionCriteria
|
Ключевые фразы и регионы, для которых требуется получить прогноз.
|
Да
||
||
`FieldNames`
|
array of HasSearchVolumeFieldEnum
|
Имена параметров, которые требуется получить.
|
Да
||

||
**Структура HasSearchVolumeSelectionCriteria**
||
||
`Keywords`
|
array of string
|
Ключевые фразы. От 1 до 10 000 элементов в массиве. Совпадающие строки не допускаются.

Ключевая фраза может содержать операторы.

<!-- source: ru/_includes/keywords/add/id-input/keyword-len.md -->
Длина ключевой фразы — не более 4096 символов. Оператор `!` перед минус-словом не учитывается в длине фразы (последовательность `-!` считается как один символ).
<!-- endsource: ru/_includes/keywords/add/id-input/keyword-len.md -->


<!-- source: ru/_includes/keywords/add/id-input/keyword-len_1.md -->
Не более 7 слов в ключевой фразе, без учета стоп-слов и минус-слов. Каждое слово — не более 35 символов, без учета минуса перед минус-словом.
<!-- endsource: ru/_includes/keywords/add/id-input/keyword-len_1.md -->
|
Да
||
||
`RegionIds`
|
array of long
|
Идентификаторы регионов, для которых показы включены или выключены.

Идентификатор 0 — показывать во всех регионах.

Минус перед идентификатором региона — выключить показы в данном регионе. Например [1,-219] — показывать для Москвы и Московской области, кроме Черноголовки. Минус-регионы нельзя использовать, если указан 0. Массив не должен состоять только из минус-регионов.
Справочник регионов можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md).
|
Да
||
|# 


## Ответ {#output}

Структура ответа в формате JSON:

```javascript translate=no
{
  "result": { /* result */
    "HasSearchVolumeResults": [{  /* HasSearchVolumeItem */
      "Keyword": (string),
      "RegionIds": [(long), ... ],
      "AllDevices": ( YES | NO ),
      "MobilePhones": ( YES | NO ),
      "Tablets": ( YES | NO ),
      "Desktops": ( YES | NO )
    }, ... ],
  }
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Тип**
|
**Описание**
||

||
**Структура result (для JSON) / HasSearchVolumeResponse (для SOAP)**
||
||
`HasSearchVolumeResults`
|
array of HasSearchVolumeItem
|
Прогноз наличия показов.
||

||
**Структура HasSearchVolumeItem**
||
||
`Keyword`
|
string
|
Ключевая фраза из запроса.
||
||
`RegionIds`
|
array of long
|
Идентификаторы регионов из запроса.
||
||
`AllDevices`
|
YesNoEnum
|
Наличие показов.
||
||
`MobilePhones`
|
YesNoEnum
|
Наличие показов на мобильных.
||
||
`Tablets`
|
YesNoEnum
|
Наличие показов на планшетах.
||
||
`Desktops`
|
YesNoEnum
|
Наличие показов на десктопах.
||
|#