Ключевые слова в топе поисковой системы по домену V4 (SerpstatDomainProcedure.getDomainKeywords)

SerpstatDomainProcedure.getDomainKeywords — метод возвращает ключевые слова в топе поисковой системы по домену. Вы можете выгрузить до 60000 результатов, используя данный метод.

Параметры запроса:

Название	Описание	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет		g_ua, y_213
url	Ссылка уточнения поиска	да	null	https://allo.ua
keywords	Массив ключевых фраз, для которых будет происходить поиск	да	[]	["купить"]
minusKeywords	Массив минус-слов при поиске	да	[]	["алло", "ало"]
filters	Условия фильтрации	да		{ "concurrency_from": "0", "concurrency_to": "1" }
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"position": "asc", "region_queries_count":"desc"}	{"cost": "asc"}
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответе	да	100	"size": {{page_size}} min: 1, max: 1000

Сортировка результатов возможна по следующим полям:

Параметр

region_queries_count

types

cost

keyword_length

concurrency

geo_names

traff

region_queries_count_wide

dynamic

position

found_results

Для фильтрации результатов используйте следующие параметры:

Параметр	Описание	Возможные значения
position_from	Минимальная позиция ключевого слова	1-100
position_to	Максимальная позиция ключевого слова	1-100
queries_from	Минимальное количество запросов в месяц	0-100000000
queries_to	Максимальное количество запросов в месяц	0-100000000
cost_from	Минимальная стоимость за клик	0-200
cost_to	Максимальная стоимость за клик	0-200
concurrency_from	Минимальное значение конкуренции	0-100
concurrency_to	Максимальное значение конкуренции	0-100

Параметры ответа:

Параметр	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100
region_queries_count	Частотность ключевой фразы в выбранном регионе
domain	Домен, который ранжируется по ключевой фразе
keyword	Ключевая фраза по которой ранжируется заданный сайт
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
url	URL, который отображается в поисковой выдаче по данному запросу
right_spelling	Рекомендация к исправлению для ключевой фразы с орфографической ошибкой
dynamic	Показывает, как изменилась позиция заданной ключевой фразы
found_results	Количество найденных результатов по ключевой фразе ""keywords""
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
position	Позиция ключевой фразы в поисковой выдаче
subdomain	Поддомен сайта, который отображается в поисковой выдаче по заданной фразе
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ).
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
left_lines	Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
"domain": "google.com",
"subdomain": "translate.google.com",
"keyword": "переводчик",
"keyword_length": 1,
"url": "https://translate.google.com/?hl=ru",
"position": 1,
"types": [
  "pic",
  "a_box_translation",
  "related_search"
],
"found_results": 39600000,
"cost": 0.2,
"concurrency": 0,
"region_queries_count": 9140000,
"region_queries_count_wide": 6120000,
"geo_names": [
  
],
"traff": 9140000,
"dynamic": 0
}

Example

Request data:


{
 "id": {{any_num_or_string}},
 "method": "SerpstatDomainProcedure.getDomainKeywords",
 "params": {
   "domain": {{domain}},
   "se": {{search_engine}},
   (optional) "sort": { {{field}}: {{"asc"|"desc"}}},
   (optional) "url": {{url}},
   (optional) "keywords": [{{keyword}}, {{keyword}}, ...],
   (optional) "minusKeywords": [{{keyword}}, {{keyword}}, ...],
   (optional) "filters": { {{field_from}}: {{value}}, {{field_to}}: {{value}}},
   (optional) "page": {{page}},
   (optional) "size": {{page_size}}
 }
}

Response data:


{
  "id": {{your_num_or_string}},
  "result": {
    "data": [
      {
        "domain": "google.com",
        "subdomain": "translate.google.com",
        "keyword": "переводчик",
        "keyword_length": 1,
        "url": "https://translate.google.com/?hl=ru",
        "position": 1,
        "types": [
          "pic",
          "a_box_translation",
          "related_search"
        ],
        "found_results": 39600000,
        "cost": 0.2,
        "concurrency": 0,
        "region_queries_count": 9140000,
        "region_queries_count_wide": 6120000,
        "geo_names": [
         
        ],
        "traff": 9140000,
        "dynamic": 0
      },
    ],
    "summary_info": {
      "page": 1,
      "left_lines": 99268,
      "total": 3809
    }
  }
}