Получение новых фраз

Метод Deep возвращает список запросов из Yandex Wordstat по исходному запросу.

Чтобы получить список запросов, необходимо выполнить POST-запрос на адрес https://moab-apis.ru/api/v1/wordstat/deep с заголовком X-Api-Key и телом запроса в виде следующего JSON-объекта:

{
  "query": "купить слона",
  "region": "225",
  "device": "All",
  "task_type": "Direct"
}

Поля соответствуют полям, описанным в разделе Frequency. Синтаксис в методе Deep не используется – запросы всегда передаются “как есть”.

Поле "device" игнорируется при использовании task_type="Direct" - не поддерживается самим сервисом. Также при использовании task_type="Direct" невозможно получить больше 500 фраз - сам сервис не отдает больше (в отличие от "Regular", где можно получить 2000 фраз).

Коды ответов аналогичны кодам, возвращаемым в разделе Region, не будем останавливаться на этом подробнее.

Если запрос выполнен успешно, в ответ вы получите HTTP-код 200 и JSON-ответ вида:

{
  "associations": [
    {
      "frequency": "794630",
      "phrase": "3 цены"
    },
    {
      "frequency": "10529",
      "phrase": "магазин динамо"
    },
    ...
  ],
  "popular": [
    {
      "frequency": "34034",
      "phrase": "купи слона"
    },
    {
      "frequency": "5435",
      "phrase": "магазин купи слона"
    },
    ...
  ]
}

В ответе представлены JSON-массивы, в которых переданы следующие значения:

• associations – “похожие” запросы вордстат (то, что раньше называлось “правой колонкой”)
• popular – “популярные” запросы wordstat (то, что раньше называлось “левой колонкой”)