Некоторые функции ограничены.
Вход Регистрация

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

Страницы-лидеры (getTopPages)

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

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса
Параметр Описание По умолчанию
id обязательно Идентификатор запроса. Допускается ввод любого числового или строкового значения.
method обязательно Название метода API: SerpstatBacklinksProcedure.getTopPages
params обязательно Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы.
query обязательно Домен анализируемого сайта. Указываем домен без http / https и "/".
searchType обязательно Режим поиска:
* domain_with_subdomains - домен с поддоменами
* domain - только домен
page опционально Номер страницы. Допустимы числовые значения. 1
size опционально Количество результатов. Допустимы числовые значения. 100
sort опционально Сортировка данных:
* ips - количество ссылающихся IP-адресов
* count - количество результатов в данном ответе
* domains - количество доменов
* url_to - целевая страница
lastupdate - дата первого обнаружения
lastupdate
order опционально Направление сортировки:
asc - по возрастанию
desc - по убыванию
desc
complexFilter опционально Фильтрация данных, вводится в виде массивов. Доступные колонки:
* path_to - внутренняя часть ссылки, без самого домена (/blog)
* url_to - целевая страница
* count - количество результатов в данном ответе
* domains - количество доменов
* ips - количество ссылающихся IP-адресов
lastupdate - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (01.01.2001)

Типы сравнения:
* gt - больше, чем. Допустимы числовые значения
* lt - меньше, чем. Допустимы числовые значения
* gte - больше или равно. Допустимы числовые значения
* lte - меньше или равно. Допустимы числовые значения
* eq - точное соответствие. Допустимы числовые и строковые значения
* neq - не соответствует. Допустимы числовые и строковые значения
* between - между. Допустимы числовые значения
* contains - содержит. Допустимы строковые значения
* notContains - не содержит. Допустимы строковые значения
* startsWith - начинается на. Допустимы строковые значения
* endsWith - заканчивается на. Допустимы строковые значения

Первые квадратные скобки перечисляют условия "ИЛИ". Вторые внутри первых - условия "И".
Параметры ответа
Параметр Описание
id Идентификатор запроса
result Инкапсулирует в себе ответ
data Массив с объектами данных
url Адрес страницы
ref_pages Количество ссылающихся страниц
ref_domains Количество ссылающихся доменов
ips Количество ссылающихся IP-адресов
url_to Страница, на которую ссылка ведет (целевая страница)
summary_info Объект с данными
left_lines Оставшийся лимит количества строк для тарифного плана
page Номер страницы
count Количество результатов в данном ответе
total Количество результатов всего по запросу
sort По каким данным происходит сортировка
order Направление сортировки: по возрастанию / убыванию

Снятие лимитов 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 PHP Python
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"
                    ]
                }
            ]
        ]
  }
}


Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "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/"
            },
            {
                "url": "/ru/blog/",
                "ref_pages": 162,
                "ref_domains": 38,
                "ips": 41,
                "urlTo": "https://serpstat.com/ru/blog/"
            }
        ],
        "summary_info": {
            "left_lines": 999971,
            "page": 1,
            "count": 2,
            "total": 826,
            "sort": "ips",
            "order": "DESC"
        }
    }
}




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

Войти Регистрация

Вы исчерпали лимит запросов.

Или email
Забыли пароль?
Или email
Optional
Back To Login

Не волнуйтесь! Напишите свой электронный адрес и мы пришлем вам новый пароль.

Вы уверены?

Awesome!

To complete your registration you need to enter your phone number

Назад

Мы отправили код подтверждения на ваш номер телефона

Your phone Resend code Осталось запросов

Что-то пошло не так.

Свяжитесь с нашей службой поддержки
Или подтвердите регистрацию с помощью Телеграм бота Перейдите по этой ссылке
Выберите один из проектов

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Увеличить лимиты

Улучшить тариф

Экспорт недоступен для вашего тарифного плана. Вам необходимо улучшить свой тариф до Lite или выше, чтобы получить доступ к инструменту Подробнее

Зарегистрироваться

Спасибо, мы сохранили ваши новые настройки рассылок.

Пригласить
Просмотр Редактирование

E-mail
Сообщение
необязательно
E-mail
Сообщение
необязательно

У вас закончились лимиты

Вы достигли лимита на количество созданных проектов и больше не можете создавать новые проекты. Увеличьте лимиты или удалите существующие проекты.

Я хочу больше лимитов
Открыть чат технической поддержки