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

# CreateNewWordstatReport
Запускает на сервере формирование отчета о статистике поисковых запросов.
Метод возвращает идентификатор будущего отчета. По идентификатору можно узнать о готовности отчета (метод [GetWordstatReportList](https://yandex.ru/dev/direct/doc/dg-v4/ru/reference/GetWordstatReportList.md)) и скачать отчет (метод [GetWordstatReport](https://yandex.ru/dev/direct/doc/dg-v4/ru/reference/GetWordstatReport.md)). Формирование отчета обычно занимает до одной минуты.


{% note info %}

Метод возвращает те же сведения, которые доступны в сервисе [Подбор слов](https://wordstat.yandex.ru/)[Keyword statistics](https://wordstat.yandex.com/). Статистика рассчитывается за прошедший месяц.

{% endnote %}


## Ограничения

Один пользователь за сутки может получить статистику поисковых запросов для 1000 фраз.

При вызове метода расходуются баллы (см. [Ограничения](https://yandex.ru/dev/direct/doc/dg-v4/concepts/Restrictions.html)). Если баллов недостаточно, возвращается сообщение об ошибке [152](https://yandex.ru/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode152).

Для одного пользователя на сервере хранится не более пяти отчетов (по всем кампаниям). При попытке сформировать шестой отчет возвращается сообщение об ошибке с кодом [31](https://yandex.ru/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode31). Отчеты хранятся на сервере в течение пяти часов, а затем автоматически удаляются.


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "CreateNewWordstatReport",
   "param": {
      /* NewWordstatReportInfo */
      "Phrases": [
         (string)
         ...
      ],
      "GeoID": [
         (int)
         ...
      ]
   }
}
```

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


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
|
**<sup >Требуется</sup>**
||

||
**<sub >Объект NewWordstatReportInfo</sub>**
||
||
`Phrases`
|
Массив ключевых фраз, по которым требуется получить статистику поисковых запросов (не более 10 фраз в кодировке UTF-8).

Ключевые фразы могут содержать минус-фразы. Минус-фразу из нескольких слов следует заключить в скобки, например: _холодильник -морозильник -(морозильная камера) -ремонт_.
|
Да
||
||
`GeoID`
|
Массив идентификаторов регионов. Позволяет получать статистику поисковых запросов, сделанных только в указанных регионах.

Чтобы исключить регион, перед его идентификатором ставят минус, например [1,-219] — получить статистику для Москвы и Московской области, кроме Черноголовки. Статистика выдается суммарно по всем плюс-регионам, из которых исключены все минус-регионы.

Значение 0 игнорируется.

Если регионы не указаны (например, пустой массив, или указаны только минус-регионы, или минус-регионы совпадают c плюс-регионами), статистика выдается по всем регионам.

Полный список регионов можно получить с помощью метода [GetRegions](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetRegions.html).
|
Нет
||
|#


## Результирующие данные {#output}

Метод возвращает идентификатор будущего отчета, как показано в следующем примере.

```javascript
{
   "data": 137456
}
```


## Примеры входных данных {#example}

## Python

```python
{
   'Phrases': [u'пух -винни',u'синтепон'],
   'GeoID': [213]
}
```

## PHP

```php
array(
   'Phrases' => array('пух -винни','синтепон'),
   'GeoID' => array(213)
)
```

## Perl

```perl
{
   'Phrases' => ['пух -винни','синтепон'],
   'GeoID' => [213]
}
```