Деякі функції обмежені. Зареєструйтесь безкоштовно
Switch to english interface?

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

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

Поділіться статтею з вашими друзями

Ви впевнені?

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

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

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Дякуємо, ми зберегли ваші нові налаштування розсилок.

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

Відкрити чат технічної підтримки