How You Can Help Ukrainians Today (SE Ranking Team Included)Learn here

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