Сторінки-лідери
Метод SerpstatDomainProcedure.getTopUrls повертає список сторінок різних сайтів, які релевантні до шукомої ключової фрази та отримують більш за все трафіку як по цій фразі, так й за групою пов'язаних фраз.
Ідентичний звіту «Сторінки-лідери» у Аналізі ключових слів.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
| Параметри запиту | |||||
| Параметр | Опис | Тип даних | Обов'язковий | Значенння за замовчуванням | Варіанти значень |
| id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення | int/string | так | Будь-яке текстове або числове значення. Наприклад: 1, test, тест | |
| method | Назва методу API | string | так | SerpstatDomainProcedure.getTopUrls | |
| params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | так | ||
| keyword | Фраза, за якою буде відбуватись пошук | string | так | Будь-яке текстове значення. Наприклад: "rebook" | |
| se | Ідентифікатор пошукової бази, за якою буде проводитись пошук. | string | так | g_us | |
| page | Номер сторінки | int | ні | 1 | Будь-яке числове значення |
| page_size | Кількість результатів у відповіді | int | ні | 20 | Текстове значення. Варіанти значень: 20, 50, 100, 200, 500 |
| sort | Сортування за даними | string | ні | keywords | "keywords" — Сортування за кількістю ключових слів |
| order | Напрям сортування | string | ні | desc | "desc" — Сортування за спаданням, "asc" — Сортування за зростанням |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор відповіді: відповідає id в запиті |
| result | Містить в собі відповідь |
| urls | Масив з даними відповіді |
| url | URL шукомої фрази |
| keywords | Загальна кількість ключових фраз, за якими ранжується сторінку у Google топ-100 |
| traff | Орієнтовний трафік сторінки за ключовою фразою у залежності від частотності ключа та позиції домену. |
| fbShares | Кількість шейрів (репостів) у соціальній мережі Facebook |
| summary_info | Об'єкт із загальними даними відповіді |
| left_lines | Кількість API рядків, що залишилися |
| keyword | Аналізована фраза |
| se | Використана пошукова база |
| page | Номер сторінки |
| page_size | Розмір сторінки |
| sort | Сортування запиту |
| order | Напрям сортування запиту |
| total_urls | Загальна кількість знайдених результатів |
Ліміти: за 1 запит знімається 1 ліміт API.
Request data:
{
"id": "1",
"method": "SerpstatKeywordProcedure.getTopUrls",
"params": {
"keyword": "rebook",
"se": "g_us",
"page": 1,
"page_size": 20,
"sort": "keywords",
"order": "desc"
}
}Response data:
{
"id": "1",
"result": {
"urls": [
{
"url": "https://www.cnet.com/how-to/easily-reschedule-a-canceled-or-delayed-flight-with-freebird/",
"keywords": 3,
"traff": 0,
"fbShares": "1"
},
{
"url": "http://money.com/money/5086004/winter-storm-grayson-flight-cancellations/",
"keywords": 3,
"traff": 0,
"fbShares": "7"
},
],
"summary_info": {
"left_lines": 9999894,
"keyword": "rebook",
"se": "g_us",
"page": 1,
"pageSize": 20,
"sort": "keywords",
"order": "desc",
"total": 303
}
}
}