Содержание
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.