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