Ключевые слова домена
Метод SerpstatDomainProcedure.getDomainKeywords возвращает ключевые слова в топе поисковой системы по домену. Аналогичен отчету Анализ домена — SEO-анализ — Ключевые слова. Вы можете выгрузить до 60 000 результатов, используя данный метод.
Общие параметры запроса и инструкция по использованию Serpstat API
Доступные поисковые базы
Параметры запроса |
||||
Параметр |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
id |
Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения. |
нет |
1, test |
|
method |
Название метода API |
нет |
SerpstatDomainProcedure. |
|
params |
Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] |
нет |
|
|
domain |
Имя домена |
нет |
nike.com |
|
se |
Идентификатор поисковой базы, по которой будет проходить поиск (доступны базы Google и Yandex на выбор, пример: g_us, y_157) |
нет |
g_us |
|
withSubdomains
|
Тип отслеживания: с/без учета поддоменов |
да |
true |
true | false |
url |
Ссылка уточнения поиска |
да |
null |
https://www.nike.com/soccer |
keywords |
Массив ключевых фраз, для которых будет происходить поиск |
да |
[] |
["shop", "nike"] |
minusKeywords |
Массив минус-слов при поиске |
да |
[] |
["nikes", "nke"] |
filters |
Условия фильтрации |
да |
|
{"right_spelling": true} {"right_spelling": false} {"position_dynamic": "new"} {"position_dynamic": "rise"} {"position_dynamic": "down"} |
sort |
Порядок сортировки результатов в формате: |
да |
{"position": "asc", |
{"cost": "asc"} |
page |
Номер страницы в ответе |
да |
1 |
"page": "5" |
size |
Количество результатов на страницу в ответе |
да |
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) |
right_spelling | Рекомендация к исправлению для ключевой фразы с орфографической ошибкой |
dynamic |
Показывает, как изменилась позиция заданной ключевой фразы |
summary_info |
Объект с данными ответа |
page |
Номер страницы |
total |
Количество найденных результатов |
left_lines |
Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike socer",
"keyword_length": 2,
"url": "https://www.nike.com/soccer",
"position": 1,
"types": [
"shopping_rhs",
"ads_top",
"snip_breadcrumbs"
],
"found_results": 90,
"cost": 0.48,
"concurrency": 100,
"region_queries_count": 9900,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 1484,
"difficulty": 20.35,
"right_spelling": "nike soccer",
"dynamic": 0
},
{
"id": "1",
"method": "SerpstatDomainProcedure.getDomainKeywords",
"params": {
"domain": "nike.com",
"se": "g_us",
"withSubdomains": true,
"sort": {
"position": "asc"
},
"url": "https://www.nike.com/soccer",
"keywords": [
"shop",
"nike"
],
"minusKeywords": [
"nikes",
"nke"
],
"page": "1",
"size": "10",
"filters": {
"right_spelling": false
}
}
}
{
"id": "1",
"result": {
"data": [
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike socer",
"keyword_length": 2,
"url": "https://www.nike.com/soccer",
"position": 1,
"types": [
"shopping_rhs",
"ads_top",
"snip_breadcrumbs"
],
"found_results": 90,
"cost": 0.48,
"concurrency": 100,
"region_queries_count": 9900,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 1484,
"difficulty": 20.35,
"right_spelling": "nike soccer",
"dynamic": 0
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike spccer",
"keyword_length": 2,
"url": "https://www.nike.com/soccer",
"position": 1,
"types": [
"snip_breadcrumbs"
],
"found_results": 99,
"cost": 0.48,
"concurrency": 100,
"region_queries_count": 9900,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 1484,
"difficulty": null,
"right_spelling": "nike soccer",
"dynamic": 0
}
],
"summary_info": {
"page": 1,
"total": 77,
"left_lines": 997219
}
}
}