Топ по ключевой фразе
Метод SerpstatKeywordProcedure.getKeywordFullTop возвращает последний топ-100 Google по ключевой фразе. Аналогичен отчету «Топ по фразе» в Анализе ключевых слов.
Общие параметры запроса и инструкция по использованию Serpstat API
Перечень доступных баз и стран
Параметры запроса | |||||
Параметр | Описание | Тип данных | Обязательный | Значение по умолчанию | Варианты значений |
id | Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения. | int/string | да | 1, test | |
method | Название метода API | string | да | SerpstatKeywordProcedure.getKeywordFullTop | |
params | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] | array | да | ||
keyword | Фраза, для которой будет происходить поиск | string | да | pizza | |
se | Идентификатор поисковой базы, по которой будет проходить поиск. | string | да | g_us | |
sort | Сортировка по данным (по возрастанию и убыванию) | array | нет | {"position": "asc"} | "position": "asc"/"desc" (asc — сортировка по возрастанию, desc — по убыванию) - Позиция в топ-100 "url": "asc"/"desc" - URL (asc - от A до Z; desc - от Z до A) "url_keywords_count": "asc"/"desc" - Количество ключей в URL "domain": "asc"/"desc" - Домен (asc - от A до Z; desc - от Z до A) "domain_visibility": "asc"/"desc" - Видимость "domain_keywords_organic": "asc"/"desc" - Количество ключей домена в органике "domain_keywords_ppc": "asc"/"desc" - Количество ключей домена в ррс "domain_top_10_keywords_count": "asc"/"desc" - Количество ключей домена в топ-10 "domain_sdr": "asc"/"desc" - Serpstat Domain Rank "domain_in_urls_count": "asc"/"desc" - Количество входящих ссылок домена "domain_in_domains_count": "asc"/"desc" - Количество ссылающихся доменов "domain_out_urls_count": "asc"/"desc" - Количество исходящих ссылок домена "domain_out_domains_count": "asc"/"desc" - Количество исходящих доменов |
size | Количество результатов в ответе | int | нет | 100 | "size": "50" min: 10, max: 100 |
Параметры ответа | |
Параметр | Описание |
id | Идентификатор запроса: соответствует id в запросе |
result | Содержит в себе ответ |
top | Массив с данными ответа |
position | Позиция по ключевой фразе в поисковой выдаче |
url | Страница, которая находится на указанной позиции |
url_keywords_count | Количество ключевых слов в SEO, по которым URL-адрес попадает в топ-100 результатов Google. |
domain | Домен, который ранжируется по ключевой фразе |
domain_visibility | Видимость домена в топ-20 поисковых результатов. Показатель рассчитывается по соотношению количества и популярности ключевых фраз, по которым сайт ранжируется. Подробнее о показателе |
domain_keywords_organic | Количество ключевых слов в SEO, по которым домен попадает в топ-100 результатов Google. |
domain_keywords_ppc | Количество ключевых слов РРС, по которым домен попадает в топ-100 результатов Google. |
domain_top_10_keywords_count | Количество ключевых слов в SEO, по которым домен попадает в топ-10 результатов Google. |
domain_sdr | Serpstat Domain Rank (SDR) — показатель авторитетности домена |
domain_in_urls_count | Количество входящих ссылок домена |
domain_in_domains_count | Количество ссылающихся доменов |
domain_out_urls_count | Количество исходящих ссылок домена |
domain_out_domains_count | Количество исходящих доменов |
summary_info | Объект с общими данными ответа |
keywords | Количество ключевых слов в SEO (из отчета Подбор фраз) |
frequency | Частотность ключевой фразы |
cost | Цена за клик в $ США, которая ежемесячно обновляется |
difficulty | Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100) |
concurrency | Конкуренция ключевой фразы в PPC (0-100%) |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое) |
sorting | Сортировка запроса |
left_limits | Количество оставшихся API строк |
count_top_results | Количество результатов по запросу |
keyword | Анализируемая фраза |
se | Используемый регион базы данных |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:
{
"position": 26,
"url": "https://amblerpizza.com/",
"url_keywords_count": 741,
"domain": "amblerpizza.com",
"domain_visibility": 0.070000000000000007,
"domain_keywords_organic": 2360,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 145,
"domain_sdr": 30,
"domain_in_urls_count": 191,
"domain_in_domains_count": 53,
"domain_out_urls_count": 3619,
"domain_out_domains_count": 16
}
{
"id": 1,
"method": "SerpstatKeywordProcedure.getKeywordFullTop",
"params": {
"keyword": "pizza",
"se": "g_us",
"sort": {
"domain": "asc"
},
"size": 10
}
}
{
"id": "1",
"result": {
"top": [
{
"position": 79,
"url": "https://alldayidreamaboutfood.com/easy-protein-pizza/",
"url_keywords_count": 40,
"domain": "alldayidreamaboutfood.com",
"domain_visibility": 3.1699999999999999,
"domain_keywords_organic": 153960,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 21652,
"domain_sdr": 54,
"domain_in_urls_count": 266121,
"domain_in_domains_count": 4908,
"domain_out_urls_count": 54298,
"domain_out_domains_count": 944
},
{
"position": 26,
"url": "https://amblerpizza.com/",
"url_keywords_count": 741,
"domain": "amblerpizza.com",
"domain_visibility": 0.070000000000000007,
"domain_keywords_organic": 2360,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 145,
"domain_sdr": 30,
"domain_in_urls_count": 191,
"domain_in_domains_count": 53,
"domain_out_urls_count": 3619,
"domain_out_domains_count": 16
},
{
"position": 50,
"url": "https://andpizza.com/",
"url_keywords_count": 6514,
"domain": "andpizza.com",
"domain_visibility": 0.38,
"domain_keywords_organic": 8703,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 435,
"domain_sdr": 46,
"domain_in_urls_count": 8982,
"domain_in_domains_count": 793,
"domain_out_urls_count": 270,
"domain_out_domains_count": 17
},
{
"position": 63,
"url": "https://www.barrospizza.com/",
"url_keywords_count": 9840,
"domain": "barrospizza.com",
"domain_visibility": 0.40000000000000002,
"domain_keywords_organic": 24791,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1798,
"domain_sdr": 39,
"domain_in_urls_count": 1532,
"domain_in_domains_count": 363,
"domain_out_urls_count": 474,
"domain_out_domains_count": 19
},
{
"position": 64,
"url": "https://basecamppizzaco.com/",
"url_keywords_count": 1242,
"domain": "basecamppizzaco.com",
"domain_visibility": 0,
"domain_keywords_organic": 1606,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 164,
"domain_sdr": 39,
"domain_in_urls_count": 778,
"domain_in_domains_count": 255,
"domain_out_urls_count": 72,
"domain_out_domains_count": 14
},
{
"position": 72,
"url": "https://www.beggarspizza.com/",
"url_keywords_count": 11015,
"domain": "beggarspizza.com",
"domain_visibility": 0.32000000000000001,
"domain_keywords_organic": 17914,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1435,
"domain_sdr": 36,
"domain_in_urls_count": 768,
"domain_in_domains_count": 241,
"domain_out_urls_count": 0,
"domain_out_domains_count": 0
},
{
"position": 85,
"url": "https://blackjackpizza.com/",
"url_keywords_count": 9752,
"domain": "blackjackpizza.com",
"domain_visibility": 0.72999999999999998,
"domain_keywords_organic": 21851,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1534,
"domain_sdr": 39,
"domain_in_urls_count": 766,
"domain_in_domains_count": 302,
"domain_out_urls_count": 397,
"domain_out_domains_count": 7
},
{
"position": 10,
"url": "https://www.blazepizza.com/",
"url_keywords_count": 58054,
"domain": "blazepizza.com",
"domain_visibility": 1.21,
"domain_keywords_organic": 121318,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 8165,
"domain_sdr": 54,
"domain_in_urls_count": 57332,
"domain_in_domains_count": 3047,
"domain_out_urls_count": 16,
"domain_out_domains_count": 2
},
{
"position": 88,
"url": "https://www.bookitprogram.com/",
"url_keywords_count": 11091,
"domain": "bookitprogram.com",
"domain_visibility": 0.40000000000000002,
"domain_keywords_organic": 19274,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 837,
"domain_sdr": 50,
"domain_in_urls_count": 32834,
"domain_in_domains_count": 2026,
"domain_out_urls_count": 0,
"domain_out_domains_count": 0
},
{
"position": 98,
"url": "https://www.bostons.com/",
"url_keywords_count": 8903,
"domain": "bostons.com",
"domain_visibility": 1.29,
"domain_keywords_organic": 31745,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1498,
"domain_sdr": 44,
"domain_in_urls_count": 3767,
"domain_in_domains_count": 829,
"domain_out_urls_count": 1335,
"domain_out_domains_count": 32
}
],
"summary_info": {
"keywords": 3112390,
"frequency": 2400,
"cost": 1.3799999999999999,
"difficulty": 92,
"concurrency": 2,
"types": [
"kn_graph_card",
"related_search"
],
"sorting": {
"domain": "asc"
},
"left_limits": 999875,
"count_top_results": 100,
"keyword": "pizza",
"se": "g_us"
}
}
}