nofollow

Анализ ключевых слов

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

Описание

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

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

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