Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

Сторінки-лідери (getTopPages)кількість доменів

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

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