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

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

Описание

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

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

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

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

ИмяОбязательныйОписание
sourceДаAlpha-2 код страны, которую вы проверяете
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