Проверка частоты фразы

Метод Frequency возвращает частоту фразы в Yandex Wordstat.

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

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

Опишем поля JSON-объекта подробнее:

• query – непосредственно запрос (искомая ключевая фраза)
• region – код региона Yandex. С основными кодами регионов вы можете ознакомиться, например, здесь. Если вам нужны дополнительные коды, которых нет в этом списке, вы можете воспользоваться поиском в справочнике регионов (см. соответствующий раздел данной документации). Коды можно указывать как в одиночку (225), так и через запятую (225, 213). Также можно указывать знак минус “-” перед кодом региона, чтобы исключить его из выдачи (225,-213)
  
• device – устройство. Возможные варианты значений:
  • All – все устройства
  • Desktop – десктопные компьютеры
  • Phone – мобильные устройства
  • Tablet – планшеты
    
• syntax – синтаксис запроса. Возможные варианты значений:
  • None – запрос передается “как есть”, можно использовать свой синтаксис
  • WS – запрос передается без кавычек, если передается в другом синтаксисе – будет автоматически преобразован в запрос без кавычек
  • Quotes – запрос передается в кавычках, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках
  • QuotesExclamationMark – запрос передается в кавычках и с восклицательным знаком перед каждым словом, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках и с восклицательным знаком перед каждым словом
  • QuotesSquareBrackets – запрос передается в кавычках и в квадратных скобках, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках и в квадратных скобках
  • QuotesExclamationMarkSquareBrackets – запрос передается в кавычках и с восклицательным знаком перед каждым словом и в квадратных скобках, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках и с восклицательным знаком перед каждым словом и в квадратных скобках
    
• task_type - тип задачи
  • Regular - обычный вордстат
  • Direct - вордстат из Яндекс.Директа

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

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

{
  "frequency": 34032
}

Здесь:

• frequency – частота запроса с учетом указанного региона, устройства и синтаксиса