Skip to main content

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

Метод 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 - тип задачи

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

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

{
  "frequency": 34032
}

Здесь:

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