Топ за ключовою фразою

Метод 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": 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
  }

Example

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": 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"
        }
    }
}