Топ за ключовою фразою
Метод 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 органічної видачі |
| 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
}Request data:
{
"id": 1,
"method": "SerpstatKeywordProcedure.getKeywordFullTop",
"params": {
"keyword": "pizza",
"se": "g_us",
"sort": {
"domain": "asc"
},
"size": 10
}
}Response data:
{
"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"
}
}
}