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

Метод SerpstatBacklinksProcedure.getTopPages повертає список сторінок-лідерів за кількістю вхідних посилань, а також кількість сторінок і доменів та IP-адрес, що посилаться на кожну сторінку. За набором даних аналогічний до звіту «Сторінки-лідери».

список сторінок-лідерів за кількістю вхідних посилань

Приклад використання: За допомогою методу SerpstatBacklinksProcedure.getTopPages перевіряємо, скільки зворотних посилань мають різні сторінки сайту, щоб проаналізувати його й оптимізувати майбутнє просування.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр	Опис	Тип даних	Обов'язковий	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь містить цей же ідентифікатор. Введення числового (number) або текстового (string) значення	int/string	так		будь-яке текстове або числове значення Наприклад: 1, test
method	Назва методу API	string	так		SerpstatBacklinksProcedure.getTopPages
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		так
query	Домен аналізованого сайту. Вказуємо домен без http / https і «/»	string	так		Текстове значення аналізованого домену. Наприклад: 000webhostapp.com
searchType	Режими пошуку для аналізу	string	так		* domain - тільки домен (site.com) * domain_with_subdomains - домен з піддоменами (subdomain.site.com)
page	Номер сторінки (числове значення)	int	ні	1	будь-яке числове значення
size	Кількість результатів (числове значення)	int	ні	100	числове значення у діапазоні 1-1000
order	Напрямок сортування	string	ні	desc	* asc - по зростанню * desc - по спадаючій
sort	Сортування даних	string	ні	lastupdate	* ips - кількість посилань IP-адрес * count - кількість результатів у відповіді * domains - кількість доменів * url_to - цільова сторінка * lastupdate - дата першого виявлення

Параметри фільтрації
Параметр		Опис
complexFilter		Фільтрація даних, вводиться у вигляді масивів [...] з наступними параметрами: 1) field - тип фільтру; доступні фільтри: * path_to - внутрішня частина посилання, без самого домену (/ blog) * url_to - цільова сторінка * count - кількість результатів в даному відповіді * domains - кількість доменів * ips - кількість посилань IP-адрес * lastupdate - дата першого виявлення. Формат значення: ДД.ММ.РРРР (01.01.2001) 2) compareType - умова фільтру: * gt - більше, ніж (числове значення) * lt - менше, ніж (числове значення) * gte - більше або дорівнює (числове значення) * lte - менше або дорівнює (числове значення) * eq - точна відповідність (числове та текстове значення) * neq - НЕ відповідає (числове та текстове значення) * between - між (числове значення) * contains - містить (текстове значення) * notContains - не містить (текстове значення) * startsWith - починається на (текстове значення) * endsWith - закінчується на (текстове значення) 3) value - значення для фільтрації Швидкі фільтри: additional_filters - на даний момент доступні наступні: * no_subdomains - не враховує посилання з піддоменів аналізованого домену Перші квадратні дужки перераховують умови "АБО". Другі всередині перших - умови "І".

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з об'єктами даних
url	Адреса сторінки
ref_pages	Кількість посилань
ref_domains	Кількість доменів, що посилаються
ips	Кількість посилань IP-адрес
url_to	Сторінка, на яку веде посилання (цільова сторінка)
summary_info	Об'єкт з даними
left_lines	Ліміт рядків для тарифного плану, що залишився
page	Номер сторінки
count	Кількість результатів в даній відповіді
total	Кількість результатів за запитом (всього)
sort	За якими даними відбувається сортування
order	Дані відсортовані: * asc - за зростанням * desc - за спаданням

Ліміти API знімаються таким чином: по 1 ліміту за 1 рядок результату у відповіді. Частина відповіді API, за яку знімається 1 ліміт:

{
     "url": "/blog/rank-your-page-for-a-whole-group-instead-of-a-single-keyword-with-our-new-keyword-clustering-tool/",
     "ref_pages": 114,
     "ref_domains": 69,
     "ips": 65,
     "urlTo": "https://serpstat.com/blog/rank-your-page-for-a-whole-group-instead-of-a-single-keyword-with-our-new-keyword-clustering-tool/"
}

Example

Request data:

{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getTopPages",
 "params": {
     "query": "serpstat.com",
     "searchType": "domain_with_subdomains",
     "page": 1,
     "size": 2,
     "sort": "ips",
     "order": "desc",
     "complexFilter": [
           [
                {
                    "field": "path_to",
                    "compareType": "contains",
                    "value": [
                        "blog"
                    ]
                },
                {
                    "field": "url_to",
                    "compareType": "contains",
                    "value": [
                        "serpstat"
                    ]
                },
                {
                    "field": "count",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "ips",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "domains",
                    "compareType": "gte",
                    "value": [
                        "1"
                    ]
                },
                 {
                    "additional_filters": "no_subdomains"
                }
            ]
        ]
  }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "url": "/ru/blog/kto-takoj-vebmaster/",
                "ref_pages": 122,
                "ref_domains": 75,
                "ips": 66,
                "urlTo": "https://serpstat.com/ru/blog/kto-takoj-vebmaster/"
            },
            {
                "url": "/blog/rank-your-page-for-a-whole-group-instead-of-a-single-keyword-with-our-new-keyword-clustering-tool/",
                "ref_pages": 101,
                "ref_domains": 51,
                "ips": 47,
                "urlTo": "https://serpstat.com/blog/rank-your-page-for-a-whole-group-instead-of-a-single-keyword-with-our-new-keyword-clustering-tool/"
            }
        ],
        "summary_info": {
            "left_lines": 999814,
            "page": 1,
            "count": 2,
            "total": 871,
            "sort": "ips",
            "order": "DESC"
        }
    }
}