Ключевые слова
Метод SerpstatUrlProcedure.getUrlKeywords возвращает ключевые фразы в топе поисковой системы по заданному URL. Аналогичен отчету Анализ страниц — SEO-анализ — Ключевые слова.
Общие параметры запроса и инструкция по использованию Serpstat API
Перечень доступных баз и стран
Параметры запроса | |||||
---|---|---|---|---|---|
Параметр | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
id | Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения. | int/string | нет | 1, test | |
method | Название метода API | string | нет | SerpstatUrlProcedure.getUrlKeywords | |
params | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] | array | нет | ||
url | URL страницы | string | нет | https://www.nike.com/men | |
se | Идентификатор поисковой базы, по которой будет проходить поиск (доступны базы Google и Yandex на выбор, пример: g_us, y_157) | string | нет | g_us | |
filters | Условия фильтрации | array | да |
"keyword": ["iphone", "iphone x"] "cost": "10"; "position": 1 "concurrency": "7"; "keyword_length": 1; "difficulty": 3; "traff": 3; "region_queries_count": "1000"; "region_queries_count_wide": "1000"; "url": https://serpstat.com/api/ "url_contains": https://serpstat.com/ "right_spelling": true; "right_spelling": false |
|
sort |
Порядок сортировки результатов в формате: order — направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
"sort": {"cnt": "asc"} |
page | Номер страницы в ответе | int | да | 1 | "page": "5" |
size | Количество результатов на страницу в ответе | int | да | 100 |
"size": "10" |
Параметры ответа | |
Параметр | Описание |
id | Идентификатор запроса: соответствует id в запросе |
result | Содержит в себе ответ |
data | Массив с данными ответа |
domain | Домен |
subdomain | Поддомен сайта, который отображается в поисковой выдаче по заданной фразе |
keyword | Ключевая фраза, по которой ранжируется страница |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
url | URL, который отображается в поисковой выдаче по данному запросу |
position | Позиция страницы по ключевой фразе в поисковой выдаче |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое) |
found_results | Количество найденных результатов по ключевой фразе |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
traff | Ориентировочный трафик по ключевому слову в зависимости от частоты ключевика и позиции |
difficulty | Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100) |
dynamic | Показывает, как изменилась позиция по заданной ключевой фразы |
summary_info | Объект с данными ответа |
page | Номер страницы |
total | Количество найденных ключевых фраз, по которым ранжируется страница в топе |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "man nike",
"keyword_length": 2,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"snip_breadcrumbs"
],
"found_results": 656000000,
"cost": 0.38,
"concurrency": 100,
"region_queries_count": 40500,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 6071,
"difficulty": null,
"dynamic": 0
},
{
"id": "1",
"method": "SerpstatUrlProcedure.getUrlKeywords",
"params": {
"se": "g_us",
"url": "https://www.nike.com/men",
"filters": {"cost_from": 1, "cost_to": 1000},
"sort": {"position": "asc"},
"page": "1",
"size": "10"
}
}
{
"id": "1",
"result": {
"data": [
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "man nike",
"keyword_length": 2,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"snip_breadcrumbs"
],
"found_results": 656000000,
"cost": 0.38,
"concurrency": 100,
"region_queries_count": 40500,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 6071,
"difficulty": null,
"dynamic": 0
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "buy nike men shoes",
"keyword_length": 4,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"kn_graph_carousel_list",
"a_box_card",
"snip_image_thumbnail",
"snip_breadcrumbs"
],
"found_results": 91,
"cost": 1.485899,
"concurrency": 100,
"region_queries_count": 50,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 7,
"difficulty": 80.52167499013474,
"dynamic": 0
}
],
"summary_info": {
"page": 1,
"total": 61,
"left_lines": 998269
}
}
}