API
API для проверки частотности
Добавление запроса на проверку частотности
Описание
Добавление задания на проверку частотности. Проверка одного ключевого слова — 0,005$. Проверка нескольких (от 2 до 700) ключевых слов – 0,2$.
Формат запроса
POST https://api4.seranking.com/key-volume/Параметры в запросе
Если передан region_id, проверка проводится с помощью Google.
| Имя | Обязательный | Описание |
| query | Да | Ключевое слово или массив ключевых слов |
| region_id | Да | id из списка регионов /system/volume-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.
