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

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

список страниц-лидеров анализируемого сайта

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

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

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор.	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"
        }
    }
}