Отчеты о доменах

2.1.1. Суммарный отчет по домену (domain_info)

domain_info — метод возвращает суммарную информацию по домену.

Metrics	Description
result	Инкапсулирует в себе ответ
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз по сравнению с последней датой обновления
traff_dynamic	Изменение трафика по сравнению с последней датой обновления
date	Дата текущей проверки видимости, ключевых фраз и трафика
prev_date	Предыдущая дата проверки
new_keywords	Количество новых ключевых фраз, которые появились у домена по сравнению с последней датой обновления
out_keywords	Количество ключевых фраз, которые потерял доменпо сравнению с последней датой обновления
rised_keywords	Ключевые фразы, по которым выросли позиции по сравнению с последней датой обновления
down_keywords	Ключевые фразы, по которым упали позиции по сравнению с последней датой обновления
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений в PPC
ads_dynamic	История изменений в объявлениях PPC
status_msg	Ответ: "OK" или "Error", сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Мы снимаем 1 лимит за запрос этого метода

2.1.2. История по домену (domain_history)

domain_history — метод возвращает историю изменения видимости и количества фраз по домену.

Metrics	Description
result	Инкапсулирует в себе ответ
visible_static	Видимость
visible	Видимость сайта
domain	Домен
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
ads	Количество объявлений {date}
ad_keywords	Количество ключевых фраз в PPC
new_keywords	Количество новых ключевых фраз которые появились у домена за последние N дней
out_keywords	Количество ключевых фраз которые потерял домен за последние N дней
rised_keywords	Ключевые фразы у которых выросли позиции за последние N-дней
down_keywords	Ключевые фразы у которых упали позиции за последние N-дней
date	Дата проверки определенного элемента массива
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
status_msg	Ответ: "OK" или "Error", сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"visible_static": 0.0087,
"domain": "serpstat.com",
"ads": 191,
"visible": 0.0087,
"rised_keywords": 32,
"keywords": 430,
"down_keywords": 28,
"new_keywords": 101,
"ad_keywords": 293,
"traff": 2575,
"out_keywords": 37,
"date": "2016-11-13"
},

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

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

Пагинация

Для пагинации используйте параметры:

page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page :  номер страницы (по умолчанию — 1-я страница).

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

Для сортировки результата используйте параметры:

sort : поле, по которому нужно выполнить сортировку.
order : направление сортировки (asc — по возрастанию, desc — по убыванию).

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

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

{
"domain": "example.com",
"subdomain": "www.example.com",
"keyword": "gmail и мой домен",
"keyword_length": 4,
"url": "https://www.example.com/",
"position": 43,
"types": [
"related_search",
"video"
],
"found_results": 60,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"dynamic": null,
"_id": "66411178-43"
},

2.1.4. Список URL-адресов домена (domain_urls)

domain_urls — метод возвращает URL-ы домена и количество ключевых слов для URL-а.

Пагинация

Для пагинации используйте  параметры:

page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page :  номер страницы (по умолчанию — 1-я страница).

Metrics	Description
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100
url	Страница
keyword	Ключевая фраза по которой ранжируется заданный сайт
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"url": "http://example.com/",
"keywords": 182
}

2.1.5. Сравнение доменов (domains_intersection)

domains_intersection — метод возвращает общие ключевые слова для доменов.

Пагинация

Для пагинации используйте параметры:

page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page :  номер страницы (по умолчанию — 1-я страница).

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100
region_queries_count	Частотность ключевой фразы в выбранном регионе
keyword	Ключевая фраза по которой ранжируется заданный сайт
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
keyword_id	ID ключевой фразы в нашей базе
keyword_crc	Контрольная сумма для быстрого поиска
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
found_results	Количество найденных результатов по ключевой фразе ""keywords""
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
url_crc	crc код от переменной ""url""
domain 1,2,3	Позиции сравниваемых доменов для данного ключевого слова
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"keyword": "regnm домен",
"keyword_length": 2,
"types": [
"related_search",
"pic",
"ads_top",
"ads_bot",
"snip_reviews_stars",
"snip_breadcrumbs"
],
"found_results": 6260000,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"domain1": "example.com",
"subdomain1": null,
"url1": "http://example.com/",
"position1": 86,
"dynamic1": null,
"domain3": "google.com",
"subdomain3": "support.google.com",
"url3": "https://support.google.com/domains/answer/4491208?hl=ru",
"position3": 40,
"dynamic3": null,
"domain2": "serpstat.com",
"subdomain2": null,
"url2": "https://serpstat.com/ru/blog/poisk-drop-domenov-kak-najti-istekshie-domeni-i-viyavit-potentcialnie-dropi/",
"position2": 59,
"dynamic2": null
}

2.1.6. Общие и уникальные ключевые слова (domains_uniq_keywords)

domains_uniq_keywords — метод возвращает ключевые слова домена без учета ключевых слов второго (третьего) домена.

Пагинация

Для пагинации необходимо использовать параметры:

• page_size : количество результатов на страницу (по умолчанию 100, максимум 1000)
• page :  номер страницы (по умолчанию 1-я страница)

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

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

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100
region_queries_count	Частотность ключевой фразы в выбранном регионе
domain	Домен
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
keyword	Ключевая фраза по которой ранжируется заданный сайт
url	URL страницы, которая отображается в SERP по заданной ключевой фразы
dynamic	Показывает, как изменилась позиция заданной ключевой фразы
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
keyword_crc	Контрольная сумма для быстрого поиска
found_results	Количество найденных результатов по ключевой фразе ""keywords""
url_crc	CRC код от переменной ""url""
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
position	Позиция ключевой фразы в поисковой выдаче
keyword_id	ID ключевой фразы в нашей базе
subdomain	Поддомен сайта, который отображается в поисковой выдаче по заданной фразе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ).
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"domain": "example.com",
"subdomain": null,
"keyword": "use somebody",
"keyword_length": 2,
"url": "https://example.com/",
"position": 16,
"types": [
"related_search",
"video",
"pic",
"refine_by_brand"
],
"found_results": 90,
"cost": 0,
"concurrency": 0,
"region_queries_count": 10,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"dynamic": null,
"_id": "92473146-76",
"google.com": 30,
"example.com": 56
}

2.1.7. Домены-конкуренты в поисковой выдаче (competitors)

competitors — метод возвращает список доменов-конкурентов из топ-20 поисковой выдачи Google.

Этот метод работает для ключей и для доменов.

Метрики	Описание
result	Инкапсулирует в себе ответ
domain	Домен
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз за период времени N
traff_dynamic	Изменение трафика за последний период времени N
ads_dynamic	Изменение количества ключевых фраз в контекстной рекламе
new_keywords	Количество новых ключевых фраз которые появились у домена за последние N-дней
out_keywords	Количество ключевых фраз которые потерял домен за последние N-дней
rised_keywords	Ключевые фразы, по которым выросли позиции за последние N-дней
down_keywords	Ключевые фразы,. по которым упали позиции за последние N-дней
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений
intersected	Количество фраз у домена, которые содержат искомую фразу
relevance	Общая релевантность домена к искомой фразе
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"domain": "kicksusa.com",
"visible": 10.99955,
"keywords": 300529,
"traff": 4565959,
"visible_dynamic": -1.14701,
"keywords_dynamic": -256,
"traff_dynamic": -1043552,
"ads_dynamic": 0,
"new_keywords": 3644,
"out_keywords": 3900,
"rised_keywords": 3914,
"down_keywords": 5986,
"ad_keywords": 1,
"ads": 1,
"intersected": 209719,
"not_intersected": 90810,
"relevance": 69.78,
"new_relevance": 8.99,
"our_relevance": 9.36
}

2.1.8. Отчет по рекламе с указанным именем домена (ad_keywords)

ad_keywords — метод выполняет поиск рекламных объявлений по домену или ключу.

Пагинация

Для пагинации используйте  параметры:

page_size : количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page :  номер страницы (по умолчанию 1-я страница).

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

Для сортировки результата используйте параметры:

sort : поле, по которому нужно выполнить сортировку.
order : направление сортировки (asc — по возрастанию, desc — по убыванию).

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных объявлений, которые отображаются по запросам, содержащие искомую фразу
hits	Инкапсулирует в себе ответ
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
region_queries_count_last	Частотность ключевой фразы за последний месяц
domain	Домен
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
keyword	Ключевая фраза, по которой отображается объявление
title	Заголовок объявления
url	Url объявления
text	Текст объявления
found_results	Количество найденных результатов по ключевой фразе ""keyword"
url_crc	CRC код от переменной ""url""
CRC	Контрольная сумма для быстрого поиска
cost	Цена за клик, $
concurrency	Конкурентность в контекстной рекламе (0-100)
position	Позиции объявлений в контекстной рекламе
date	Дата актуализации объявления
keywords_id	ID ключевой фразы в нашей базе
subdomain	Поддомен
type	Место размещения объявления в SERP (1. Над; 2. Под; 3. Справа)
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое )
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
"keyword": "nike air force 1",
"keyword_length": 4,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/w/air-force-1-shoes-5sj3yzy7ok?cp=15839883195_search_%7Cnike+air+force+1%7CGOOGLE%7C71700000042134106%7CAll_X_X_X_X-Device_X_AF1-General_Exact%7Ce%7Cc&gclid=EAIaIQobChMIj6f9r4Sx5QIVR3ZgCh360Qx6EAAYASAAEgL9FPD_BwE&gclsrc=aw.ds",
"title": "Nike Air Force 1 | Nike Official Site",
"text": "Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear.",
"position": 1,
"type": 1,
"cost": 0.71,
"concurrency": 100,
"found_results": 69,
"region_queries_count": 90500,
"region_queries_count_wide": 0,
"region_queries_count_last": 0,
"types": [
"related_search",
"also_asks",
"ads_top",
"shopping_top"
],
"geo_names": [

],
"_id": "24829288_1"
}

2.1.9. Страницы-лидеры домена (get_top_urls)

В этом отчете вы найдете все страницы анализируемого домена в иерархическом порядке. Кроме того, он показывает количество ключевых фраз, по которым страница ранжируется в топе, потенциальный трафик, количество шейров в социальных сетях Facebook, LinkedIn.

Метод get_top_urls может работать продолжительное время, из-за специфики сбора данных.
По умолчанию результаты отсортированы по количеству фраз, по убыванию: order=desc&sort=organic_keywords.

Пагинация
Для пагинации используйте параметры:

• page_size: количество результатов на страницу (по умолчанию — 100, максимум —1000).
• page: номер страницы (по умолчанию — 1-я страница) — каждое изменение параметра считается новым запросом и влияет на лимиты.

Сортировка
Для сортировки используйте параметры:

• sort: поле, по которому нужно выполнить сортировку (organic_keyword, facebook_shares, linkedin_shares, potencial_traff). Например, sort=organic_keywords&page_size=100 .
• order: сортировка  по убыванию "desc" или по возрастанию "asc" ( default: desc ). Например, order=desc .

Metrics	Description
result	Инкапсулирует в себе ответ
total	Всего найдено страниц у домен
top_urls	Инкапсулирует с в себе ответ
url	URL домена
organic_keywords	Общее количество ключевых фраз, по которым ранжируется страница в Google топ-100 или Яндекс топ-50
facebook_shares	Количестве шейров в социальной сети Facebook, которое получила страница анализируемого домена
potencial_traff	Количество посетителей в месяц, которые страница получит в том случае, если займет по всем фразам из топ-20 первую позицию в поисковой выдаче Google или Yandex. Данный показатель рассчитывается исходя из соотношения реального и максимально возможного трафика
status_msg	Ответ: "OK" или "Error" сообщает об удачном или неудачном запросе
status_code	Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

2.1.10. Суммарный отчет по домену V4 (SerpstatDomainProcedure.getDomainsInfo)

SerpstatDomainProcedure.getDomainsInfo — метод возвращает суммарную информацию по массиву доменов.

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

Название	Описание	Опциональный	Варианты значений
domains	Массив доменов	нет	["allo.ua", "citrus.ua" ]
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет	g_ua, y_213

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

Параметры	Описание
result	Инкапсулирует в себе ответ
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз за последние 2 недели
traff_dynamic	Изменение трафика за последние 2 недели
date	Дата текущей проверки видимости, ключевых фраз и трафика
prev_date	Предыдущая дата проверки
new_keywords	Количество новых ключевых фраз, которые появились у домена за последние 2 недели
out_keywords	Количество ключевых фраз, которые потерял домен за последние 2 недели
rised_keywords	Ключевые фразы, по которым выросли позиции за последние 2 недели
down_keywords	Ключевые фразы, по которым упали позиции за последние 2 недели
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений в PPC
ads_dynamic	История изменений в объявлениях PPC
left_lines	Количество оставшихся API строк

Лимиты: за каждый домен, по которому получена информация снимается 1 лимит. Часть ответа API, за которую снимается 1 лимит:

{
 "domain": "allo.ua",
 "visible": 1427.64772,
 "keywords": 21834506,
 "traff": 137705752,
 "visible_dynamic": -51.550359999999955,
 "keywords_dynamic": -76425,
 "traff_dynamic": 17517324,
 "ads_dynamic": 18237,
 "new_keywords": 17040,
 "out_keywords": 17179,
 "rised_keywords": 21708,
 "down_keywords": 44294,
 "ad_keywords": 161823,
 "ads": 122695,
 "visible_mysql": 0,
 "prev_date": "2020-01-27"
}

2.1.11. История по домену V4 (SerpstatDomainProcedure.getDomainsHistory)

SerpstatDomainProcedure.getDomainsHistory — метод возвращает историю изменения видимости и количества фраз по домену.

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

Метрика	Описание	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет	-	allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет	-	g_ua
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	-	{"ads":"desc"}
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответе	да	100	100-1000

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

Параметр

date

down_keywords

visible

rised_keywords

keywords

traff

visible_static

new_keywords

out_keywords

down_keywords

ad_keywords

Метрики ответа:

Метрики	Описание
result	Инкапсулирует в себе ответ
visible	Видимость сайта
domain	Домен
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный органический трафик на сайт (количество посетителей)
date	Дата текущей проверки видимости, ключевых фраз и трафика
new_keywords	Количество новых ключевых фраз, которые появились у домена за последние 2 недели
out_keywords	Количество ключевых фраз, которые потерял домен за последние 2 недели
rised_keywords	Ключевые фразы, по которым выросли позиции за последние 2 недели
down_keywords	Ключевые фразы, по которым упали позиции за последние 2 недели
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений в PPC
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов. Часть ответа API, за которую снимается 1 лимит:

{
"domain": "google.com",
"rised_keywords": 176915,
"visible": 5995.61211,
"traff": 120802965,
"keywords": 3964146,
"visible_static": 5995.61211,
"date": "2018-07-05",
"ads": 1662,
"new_keywords": 184914,
"down_keywords": 232468,
"ad_keywords": 7638,
"out_keywords": 146804
}

2.1.12. Ключевые слова в топе поисковой системы по домену 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

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

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

Параметр	Описание
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
}

2.1.13. Список URL-адресов домена V4 (SerpstatDomainProcedure.getDomainUrls)

SerpstatDomainProcedure.getDomainUrls — метод возвращает URL домена и количество ключевых слов для URL.

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

Название	Описание	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет	-	allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет	-	g_ua, g_ru, ...
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"keywords":"desc"}	{"keywords":"asc"}
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответе	да	100	"size": {{page_size}} min: 1, max: 1000

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

Параметр

keywords

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

Параметр	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных URL
url	Страница
keyword	Количество ключевых фраз по которой ранжируется данная страница
left_lines	Количество оставшихся API строк

Лимиты:  Количество списанных лимитов соответствует количеству полученных результатов по запросу.  Часть ответа API, за которую снимается 1 лимит:

{
"url": "https://play.google.com/store?hl=ru",
"keywords": 4938
}

2.1.14. Сравнение доменов V4 (SerpstatDomainProcedure.getDomainsIntersection)

SerpstatDomainProcedure.getDomainsIntersection — метод возвращает общие ключевые слова для доменов.

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

Название	Описание	Опциональный	Значение по умолчанию	Варианты значений
domains	массив доменов min2, max3	нет		["allo.ua", "citrus.ua"]
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет		g_ua, g_ru, ...
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответе	да	100	"size": {{page_size}} min: 1, max: 1000

Метрики ответа:

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

Лимиты:  Количество списанных лимитов соответствует количеству полученных результатов по запросу.  Часть ответа API, за которую снимается 1 лимит:

{
"keyword": "знімок екрану леново",
"keyword_length": 3,
"types": [
  "pic",
  "related_search",
  "also_asks"
],
"found_results": 100,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [
  
],
"traff": 0,
"domain3": "rozetka.ua",
"subdomain3": "i1.rozetka.ua",
"url3": "https://i1.rozetka.ua/goods/documents/1079791/lenovo_vibe_k5_note_pro_silver_documents_1079791792.pdf",
"position3": 19,
"dynamic3": null,
"domain2": "citrus.ua",
"subdomain2": "www.citrus.ua",
"url2": "https://www.citrus.ua/planshety/lenovo-yoga3-x50f-16gbl-za0h0060ua-608291.html",
"position2": 42,
"dynamic2": null,
"domain1": "allo.ua",
"subdomain1": "blog.allo.ua",
"url1": "https://blog.allo.ua/obzor-smartfona-lenovo-vibe-x2_2014-11-13/",
"position1": 30,
"dynamic1": null
}

2.1.15. Общие и уникальные ключевые слова V4 (SerpstatDomainProcedure.getDomainsUniqKeywords)

SerpstatDomainProcedure.getDomainsUniqKeyword — метод возвращает ключевые фразы домена без учета ключевых фраз минус-домена.

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

Название	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
domains	массив имен доменов min 1, max 2	array	нет		["allo.ua", "citrus.ua"]
minusDomain	имя домена, ключевые фразы которого, не должны пересекаться с доменами параметра domains	string	нет	---	rozetka.com.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
filters	Условия фильтраци	array	да	---	{"queries_from": 10} {"queries_to": 10}
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	"size": {{page_size}} min: 1, max: 1000

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

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

Метрики ответа:

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

Лимиты: Количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
"domain": "allo.ua",
"subdomain": null,
"keyword": "купить дом в чернигове бу",
"keyword_length": 5,
"url": "https://allo.ua/ru/mobilnye-telefony-i-sredstva-svyazi/",
"position": 42,
"date": "2019-04-08",
"types": [
    "pic",
    "related_search"
],
"found_results": 62,
"cost": 0,
"concurrency": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"geo_names": [
    "чернигове"
],
"traff": 0,
"dynamic": 15,
"citrus.ua": 40,
"allo.ua": 42
}

2.1.16. Домены-конкуренты в поисковой выдаче V4 (SerpstatDomainProcedure.getCompetitors)

SerpstatDomainProcedure.getCompetitors — метод возвращает список доменов-конкурентов из топ-20 поисковой выдачи Google

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

Название	Описание	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет		g_ua
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"relevance":"desc"}	{"ads":"desc"}
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответа	да	100	50-1000

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

Параметр

visible

keywords

traff

visible_dynamic

keywords_dynamic

traff_dynamic

ads_dynamic

new_keywords

out_keywords

rised_keywords

down_keywords

ad_keywords

ads

intersected

relevance

new_relevance

our_relevance

Метрики ответа:

Метрики	Описание
result	Инкапсулирует в себе ответ
domain	Домен
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз за период времени N
traff_dynamic	Изменение трафика за последний период времени N
ads_dynamic	Изменение количества ключевых фраз в контекстной рекламе
new_keywords	Количество новых ключевых фраз которые появились у домена за последние N-дней
out_keywords	Количество ключевых фраз которые потерял домен за последние N-дней
rised_keywords	Ключевые фразы, по которым выросли позиции за последние N-дней
down_keywords	Ключевые фразы,. по которым упали позиции за последние N-дней
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений
intersected	Количество фраз у домена, которые содержат искомую фразу
relevance	Общая релевантность домена к искомой фразе
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
"domain": "google.com",
"visible": 6292.39888,
"keywords": 514454762,
"traff": 2795219750,
"visible_dynamic": -132.55671,
"keywords_dynamic": 48860651,
"traff_dynamic": 927779,
"ads_dynamic": 554,
"new_keywords": 54740992,
"out_keywords": 5880341,
"rised_keywords": 1010039,
"down_keywords": 985120,
"ad_keywords": 62679,
"ads": 41551,
"intersected": 514454762,
"relevance": 100,
"new_relevance": 100,
"our_relevance": 100
}

2.1.17. Рекламные объявления по домену V4 (SerpstatDomainProcedure.getAdKeywords)

SerpstatDomainProcedure.getAdKeywords — метод выполняет поиск рекламных объявлений по домену.

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

Описание	Тип	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет		g_ua, g_ru, ...
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

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

Параметр

keyword_length

position

type

cost

concurrency

found_results

region_queries_count

region_queries_count_wide

types

difficulty

geo_names

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

Метрики ответа:

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных объявлений, которые отображаются по запросам, содержащим искомую фразу
hits	Инкапсулирует в себе ответ
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
region_queries_count_last	Частотность ключевой фразы за последний месяц
domain	Домен объявления
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
keyword	Ключевая фраза, по которой отображается объявление
title	Заголовок объявления
url	Url объявления, который отображается в поисковой выдаче по данному запросу
text	Текст объявления, который отображается в поисковой выдаче по данному запросу
found_results	Количество найденных результатов по ключевой фразе ""keyword"
url_crc	CRC код от переменной ""url""
CRC	Контрольная сумма для быстрого поиска
cost	Цена за клик, $
concurrency	Конкурентность в контекстной рекламе (0-100)
position	Позиции объявлений в контекстной рекламе
date	Дата когда был пробит SERP
keywords_id	ID ключевой фразы в нашей базе
subdomain	Поддомен
type	Место размещения объявления в SERP (1. Над; 2. Под; 3. Справа)
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое )
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
"keyword": "gmail.coṃ",
"keyword_length": 1,
"domain": "google.com",
"subdomain": "gsuite.google.com",
"url": "https://gsuite.google.com/intl/ru/products/gmail/",
"title": "Рабочая почта Gmail от Google | Работайте там, где вам удобно",
"text": "Надежная почта, онлайн хранение, календарь, видеочат.",
"position": 1,
"type": 1,
"cost": 0.05,
"concurrency": 7,
"found_results": 13,
"region_queries_count": 74000,
"region_queries_count_wide": 0,
"types": [
  "pic",
  "ads_top"
],
"geo_names": [
 
]
}

2.1.18. Страницы-лидеры домена V4 (SerpstatDomainProcedure.getTopUrls)

SerpstatDomainProcedure.getTopUrls — метод возвращает лучшие страницы анализируемого домена по количеству ключевых фраз в региональной выдаче поисковой системы. Также он показывает потенциальный трафик, количество шейров в Facebook.

Данный метод может работать продолжительное время, из-за специфики сбора данных. По умолчанию результаты отсортированы по количеству фраз, по убыванию.

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

Название	Описание	Тип	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	string	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	json object	да	{"organic_keywords":"desc"}	{"organic_keywords":"desc"}
filters	Условия фильтрации	json object	да	---	{"url_prefix": "https://allo.ua/ru/products/"} {"url_contain": "style"} {"url_not_contain": "style"}
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	50-1000

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

Параметр

organic_keywords

facebook_shares

potencial_traff

Метрики ответа:

Метрика	Описание
result	Инкапсулирует в себе ответ
total	Всего найдено страниц у домена
url	URL страницы
organic_keywords	Общее количество ключевых фраз, по которым ранжируется страница в Google топ-100 или Яндекс топ-50
facebook_shares	Количестве шейров страницы в Facebook
potencial_traff	Количество посетителей в месяц, которые страница получит в том случае, если займет по всем фразам из топ-20 первую позицию в поисковой выдаче Google или Yandex. Данный показатель рассчитывается исходя из соотношения реального и максимально возможного трафика.
left_lines	Количество оставшихся API строк

Лимиты:  количество списанных лимитов соответствует количеству полученных результатов по запросу.

{
"url": "https://photos.google.com/",
"organic_keywords": 20425,
"facebook_shares": 228162,
"potencial_traff": 11342451
}

2.1.19. Домены-конкуренты PPC V4 (SerpstatDomainProcedure.getAdsCompetitors)

SerpstatDomainProcedure.getAdsCompetitors — метод возвращает список доменов-конкурентов PPC

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

Название	Описание	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет		g_ua
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"relevance":"desc"}	{"ads":"desc"}
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответа	да	100	50-1000

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

Параметр

ads

keywords

intersected

missing_keywords

Метрики ответа:

Метрики	Описание
result	Инкапсулирует в себе ответ
ads	Количество объявлений
domain	Домен
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
intersected	Количество фраз у домена, которые содержат искомую фразу
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
  "domain": "eldorado.ua",
  "keywords": 1155,
  "ads": 1319,
  "intersected": 207,
  "missing_keywords": 948
},

2.1.20. Получение статистики по лимитам V4 (SerpstatLimitsProcedure.getStats)

SerpstatLimitsProcedure.getStats — метод для проверки количества доступных и использованных дневных лимитов для API и расширения для браузеров Serpstat Website SEO Checker.

Лимиты за использование этого метода не снимаются.

Метрики ответа:

Название	Описание	Тип
max_lines	Максимальное доступное в день количество API лимитов	int
used_lines	Количество использованных API лимитов за текущий день	int
left_lines	Количество доступных API лимитов на текущий день	int
user_info	Информация пользователя API	json object
user_id	Идентификатор пользователя в Serpstat	int
plugin_limits	Информация по API-лимитам расширения для браузеров Serpstat	json object
delayBetweenRequests	Количество запросов к API расширения для браузеров Serpstat в секунду	int
hasApiPlugin	Наличие доступа к API расширения для браузеров Serpstat: true - есть доступ false - нет доступа	bool
total	Количество лимитов в день к API расширения для браузеров Serpstat	int
used	Количество использованных лимитов за текущий день к API расширения	int
left	Количество оставшихся лимитов на текущий день к API расширения	int

2.1.20. Получение статистики по лимитам V4 (SerpstatLimitsProcedure.getStats)

SerpstatLimitsProcedure.getStats — метод для проверки количества доступных и использованных дневных лимитов для API и расширения для браузеров Serpstat Website SEO Checker.

Лимиты за использование этого метода не снимаются.

Метрики ответа:

Название	Описание	Тип
max_lines	Максимальное доступное в день количество API лимитов	int
used_lines	Количество использованных API лимитов за текущий день	int
left_lines	Количество доступных API лимитов на текущий день	int
user_info	Информация пользователя API	json object
user_id	Идентификатор пользователя в Serpstat	int
plugin_limits	Информация по API-лимитам расширения для браузеров Serpstat	json object
delayBetweenRequests	Количество запросов к API расширения для браузеров Serpstat в секунду	int
hasApiPlugin	Наличие доступа к API расширения для браузеров Serpstat: true - есть доступ false - нет доступа	bool
total	Количество лимитов в день к API расширения для браузеров Serpstat	int
used	Количество использованных лимитов за текущий день к API расширения	int
left	Количество оставшихся лимитов на текущий день к API расширения	int