Содержание
API для проверки частотности
Добавление запроса на проверку частотности
Описание
Добавление задания на проверку частотности. Проверка одного ключевого слова — 0,005$. Проверка нескольких (от 2 до 700) ключевых слов – 0,2$.
Формат запроса
POST https://api4.seranking.com/key-volume/Параметры в запросе
Если передан region_id, проверка проводится с помощью Google, если передан регион Яндекса и тип – с помощью Яндекс.
| Имя | Обязательный | Описание |
| query | Да | Ключевое слово или массив ключевых слов |
| region_id | Да | id из списка регионов /system/volume-regions |
| yandex_region_code | Да – если нет region_id | id из списка регионов /system/yandex-regions |
| type | Да – если нет region_id | broad – Широкое phrase – «Фразовое» exact – «!Точное» |
Результат
В случае успеха сервер возвращает ID задания на проверку.
Пример ответа
{
id:1
}Ошибки
| HTTP-код | Сообщение об ошибке |
| 400 | Invalid region id |
| 400 | Invalid |
Список заданий
Формат запроса
GET https://api4.seranking.com/key-volume/Результат
Список заданий на проверку.
Пример ответа
[
{
«id»:1,
«add_time»:»2018-08-15 12:51:21″,
«total_queries» :1,
«total_finished» :1,
«country’ :»USA»
}
]Результаты проверки
Формат запроса
GET https://api4.seranking.com/key-volume/{task_id}Результат
Возвращает результат проверки или статус.
Пример ответа
Если результат ещё не получен.
{
«status» : «processing»
}Если результат готов.
[
{
“query”:”query 1”,
“volume”:2342
}
]
Удаление задания на проверку
Формат запроса
DELETE https://api4.seranking.com/key-volume/{task_id}Результат
В случае успеха сервер возвращает HTTP 204.