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

}

Ошибки

Формат запроса

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.