Сторінки-лідери

Метод 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.

Example

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