CreateNewWordstatReport

Запускает на сервере формирование отчета о статистике поисковых запросов.

Метод возвращает идентификатор будущего отчета. По идентификатору можно узнать о готовности отчета (метод GetWordstatReportList) и скачать отчет (метод GetWordstatReport). Формирование отчета обычно занимает до одной минуты.

Примечание. Метод возвращает те же сведения, которые доступны в сервисе Подбор слов. Статистика рассчитывается за прошедший месяц.

Ограничения

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

При вызове метода расходуются баллы (см. Ограничения на использование). Если баллов недостаточно, возвращается сообщение об ошибке 152.

Для одного пользователя на сервере хранится не более пяти отчетов (по всем кампаниям). При попытке сформировать шестой отчет возвращается сообщение об ошибке с кодом 31. Отчеты хранятся на сервере в течение пяти часов, а затем автоматически удаляются.

Входные данные

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

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

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

Параметр Описание Требуется
Объект NewWordstatReportInfo
Phrases

Массив ключевых фраз, по которым требуется получить статистику поисковых запросов (не более 10 фраз в кодировке UTF-8).

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

Да
GeoID

Массив идентификаторов регионов. Позволяет получать статистику поисковых запросов, сделанных только в указанных регионах.

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

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

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

Полный список регионов можно получить с помощью метода GetRegions.

Нет
Параметр Описание Требуется
Объект NewWordstatReportInfo
Phrases

Массив ключевых фраз, по которым требуется получить статистику поисковых запросов (не более 10 фраз в кодировке UTF-8).

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

Да
GeoID

Массив идентификаторов регионов. Позволяет получать статистику поисковых запросов, сделанных только в указанных регионах.

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

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

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

Полный список регионов можно получить с помощью метода GetRegions.

Нет

Результирующие данные

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

{
   "data": 137456
}

Примеры входных данных

Python

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

PHP

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

Perl

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