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

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

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

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

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

- **query** – непосредственно запрос (искомая ключевая фраза)
- **region** – код региона Yandex. С основными кодами регионов вы можете ознакомиться, например, [здесь](https://yandex.ru/dev/xml/doc/ru/reference/regions). Если вам нужны дополнительные коды, которых нет в этом списке, вы можете воспользоваться поиском в справочнике регионов (см. соответствующий раздел данной документации). Коды можно указывать как в одиночку (225), так и через запятую (225, 213). Также можно указывать знак минус “-” перед кодом региона, чтобы исключить его из выдачи (225,-213)
- **device** – устройство. Возможные варианты значений: 
    - **All** – все устройства
    - **Desktop** – десктопные компьютеры
    - **Phone** – мобильные устройства
    - **Tablet** – планшеты
- **syntax** – синтаксис запроса. Возможные варианты значений: 
    - **None** – запрос передается “как есть”, можно использовать свой синтаксис
    - **WS** – запрос передается без кавычек, если передается в другом синтаксисе – будет автоматически преобразован в запрос без кавычек
    - **Quotes** – запрос передается в кавычках, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках
    - **QuotesExclamationMark** – запрос передается в кавычках и с восклицательным знаком перед каждым словом, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках и с восклицательным знаком перед каждым словом
    - **QuotesSquareBrackets** – запрос передается в кавычках и в квадратных скобках, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках и в квадратных скобках
    - **QuotesExclamationMarkSquareBrackets** – запрос передается в кавычках и с восклицательным знаком перед каждым словом и в квадратных скобках, если передается в другом синтаксисе – будет автоматически преобразован в запрос в кавычках и с восклицательным знаком перед каждым словом и в квадратных скобках
- **task\_type** - тип задачи 
    - **Regular** - обычный вордстат
    - **Direct** - вордстат из [Яндекс.Директа](https://direct.yandex.ru/registered/main.pl?checkboxes=1&cmd=wordstat&from_forecast=1&tm=&geo=0)

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

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

```json
{
  "frequency": 34032
}
```

Здесь:

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