API для анализа ключевых слов

Получение данных для ключевых слов

Описание

Метод позволяет получить данные по ключевым словам.

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

POST https://api4.seranking.com/research/{source}/analyze-keywords/

Параметры в запросе

ИмяОбязательныйОписание
sourceДаБаза, к которой производится запрос
keywordsДаКлючевые слова, по которым нужно получить данные. Максимальное количество в одном запросе — 5 000
sortНетПоле сортировки (по умолчанию — CPC)
sort_orderНетПорядок сортировки: asc или desc (desc по умолчанию)
colsНетСписок возвращаемых значений (через запятую)

Результат

В случае успеха сервер возвращает список ключевых слов с данными.

Пример:

[

 {

      is_data_found: true,

      keyword: “seranking.com”,

      volume: 10,

      cpc: 0.00,

      competition: “0.00”,

      difficulty: 90,

      history_trend: {

            “2020-03-01”: 10,

            “2020-04-01”: 10,

            “2020-05-01”: 10,

            “2020-06-01”: 10,

            “2020-07-01”: 10,

            “2020-08-01”: 10,

            “2020-09-01”: 10,

            “2020-10-01”: 10,

            “2020-11-01”: 10,

            “2020-12-01”: 10,

            “2021-01-01”: 10,

            “2021-02-01”: 10

      }

},

…

]

Параметры ответа

ИмяОписание
is_data_foundtrue или false, найдены ли данные по ключевому слову
keywordКлючевое слово
volumeЧастотность
cpcCPC
competitionКонкуренция
difficultyСложность ключевого слова
history_trendИстория изменения частотности

Ошибки

HTTP-кодСообщение об ошибке
400Incorrect order field {sort} {sort_order}
400Exceeded keywords size. Max keywords for one request: 10000
400Invalid keywords
400Invalid source