Топ за ключовою фразою
Метод 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": 27,
"url": "https://www.zpizza.com/",
"url_keywords_count": 3162,
"domain": "zpizza.com",
"domain_visibility": 0.07,
"domain_keywords_organic": 9120,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1101,
"domain_sdr": 44,
"domain_in_urls_count": 6265,
"domain_in_domains_count": 716,
"domain_out_urls_count": 452,
"domain_out_domains_count": 129
}
{
"id": 1,
"method": "SerpstatKeywordProcedure.getKeywordFullTop",
"params": {
"keyword": "pizza",
"se": "g_us",
"sort": {
"domain": "asc"
},
"size": 10
}
}
{
"id": "1",
"result": {
"top": [
{
"position": 27,
"url": "https://www.zpizza.com/",
"url_keywords_count": 3162,
"domain": "zpizza.com",
"domain_visibility": 0.07,
"domain_keywords_organic": 9120,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 1101,
"domain_sdr": 44,
"domain_in_urls_count": 6265,
"domain_in_domains_count": 716,
"domain_out_urls_count": 452,
"domain_out_domains_count": 129
},
{
"position": 29,
"url": "https://www.youtube.com/watch?v=0w8YpBjsW6Y",
"url_keywords_count": 99,
"domain": "youtube.com",
"domain_visibility": 22059.88,
"domain_keywords_organic": 480765206,
"domain_keywords_ppc": 4,
"domain_top_10_keywords_count": 106713777,
"domain_sdr": 99,
"domain_in_urls_count": 8774661393,
"domain_in_domains_count": 22344395,
"domain_out_urls_count": 94697,
"domain_out_domains_count": 163
},
{
"position": 65,
"url": "https://www.youtube.com/watch?v=263uoOoWf9c",
"url_keywords_count": 68,
"domain": "youtube.com",
"domain_visibility": 22059.88,
"domain_keywords_organic": 480765206,
"domain_keywords_ppc": 4,
"domain_top_10_keywords_count": 106713777,
"domain_sdr": 99,
"domain_in_urls_count": 8774661393,
"domain_in_domains_count": 22344395,
"domain_out_urls_count": 94697,
"domain_out_domains_count": 163
},
{
"position": 56,
"url": "https://www.yelp.com/search?cflt=pizza&find_loc=Mentone%2C+AL",
"url_keywords_count": 20,
"domain": "yelp.com",
"domain_visibility": 3155.87,
"domain_keywords_organic": 82668431,
"domain_keywords_ppc": 15,
"domain_top_10_keywords_count": 36075286,
"domain_sdr": 82,
"domain_in_urls_count": 71352727,
"domain_in_domains_count": 634321,
"domain_out_urls_count": 13029,
"domain_out_domains_count": 466
},
{
"position": 67,
"url": "https://www.yelp.com/search?cflt=pizza&find_loc=Hopewell%2C+VA",
"url_keywords_count": 15,
"domain": "yelp.com",
"domain_visibility": 3155.87,
"domain_keywords_organic": 82668431,
"domain_keywords_ppc": 15,
"domain_top_10_keywords_count": 36075286,
"domain_sdr": 82,
"domain_in_urls_count": 71352727,
"domain_in_domains_count": 634321,
"domain_out_urls_count": 13029,
"domain_out_domains_count": 466
},
{
"position": 3,
"url": "https://en.wikipedia.org/wiki/Pizza",
"url_keywords_count": 8737,
"domain": "wikipedia.org",
"domain_visibility": 37845.97,
"domain_keywords_organic": 241512021,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 76138842,
"domain_sdr": 94,
"domain_in_urls_count": 1419295195,
"domain_in_domains_count": 6636517,
"domain_out_urls_count": 194046257,
"domain_out_domains_count": 607822
},
{
"position": 61,
"url": "https://www.wfaa.com/article/life/food/donatos-pizza-expansion-dallas-fort-worth/287-a7099672-b807-45e2-b978-904d21be8398",
"url_keywords_count": 41,
"domain": "wfaa.com",
"domain_visibility": 28.87,
"domain_keywords_organic": 975269,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 50721,
"domain_sdr": 66,
"domain_in_urls_count": 558794,
"domain_in_domains_count": 19665,
"domain_out_urls_count": 2,
"domain_out_domains_count": 2
},
{
"position": 34,
"url": "https://www.vpizza.com/",
"url_keywords_count": 4363,
"domain": "vpizza.com",
"domain_visibility": 0.01,
"domain_keywords_organic": 8162,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 422,
"domain_sdr": 38,
"domain_in_urls_count": 599,
"domain_in_domains_count": 236,
"domain_out_urls_count": 526,
"domain_out_domains_count": 26
},
{
"position": 38,
"url": "https://unapizza.com/",
"url_keywords_count": 1530,
"domain": "unapizza.com",
"domain_visibility": 0.08,
"domain_keywords_organic": 2098,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 196,
"domain_sdr": 42,
"domain_in_urls_count": 4744,
"domain_in_domains_count": 408,
"domain_out_urls_count": 206,
"domain_out_domains_count": 40
},
{
"position": 73,
"url": "https://www.tributepizza.com/",
"url_keywords_count": 836,
"domain": "tributepizza.com",
"domain_visibility": 0.01,
"domain_keywords_organic": 1064,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 44,
"domain_sdr": 35,
"domain_in_urls_count": 467,
"domain_in_domains_count": 111,
"domain_out_urls_count": 120,
"domain_out_domains_count": 13
}
],
"summary_info": {
"keywords": 3123661,
"frequency": 6120000,
"cost": 2,
"difficulty": 93,
"concurrency": 10,
"types": [
"related_search",
"kn_graph_card"
],
"sorting": {
"domain": "desc"
},
"left_limits": 999360,
"count_top_results": 100,
"keyword": "pizza",
"se": "g_us"
}
}
}