API
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_found | true или false, найдены ли данные по ключевому слову |
| keyword | Ключевое слово |
| volume | Частотность |
| cpc | CPC |
| competition | Конкуренция |
| difficulty | Сложность ключевого слова |
| history_trend | История изменения частотности |
Ошибки
| HTTP-код | Сообщение об ошибке |
| 400 | Incorrect order field {sort} {sort_order} |
| 400 | Exceeded keywords size. Max keywords for one request: 10000 |
| 400 | Invalid keywords |
| 400 | Invalid source |
