Некоторые функции ограничены. Зарегистрируйтесь бесплатно
Switch to english interface?

Входящие потерянные ссылки

Метод getLostBacklinks возвращает список утерянных ссылок на анализируемый сайт, аналогичен отчетe «Потерянные ссылки»

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

Параметры запроса
Параметр Описание По умолчанию
id обязательно Идентификатор запроса. Ввод числового (number) или текстового (string) значения.
method обязательно Название метода API: SerpstatBacklinksProcedure.getLostBacklinks
params обязательно Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...].
query обязательно Домен анализируемого сайта. Указываем домен без http / https и "/".
searchType обязательно Режимы поиска для анализа:
* domain - только домен (site.com)
* domain_with_subdomains - домен, включающий поддомен (subdomain.site.com)
* URL - конкретная страница (site.com/path/)
* part_url - адрес страницы начинается с (site.com/path/*)
page опционально Номер страницы (числовое значение) 1
size опционально Количество результатов (числовое значение) 100
sort опционально Сортировка данных:
url_from - ссылающаяся страница
anchor - анкор входящей ссылки
link_nofollow - атрибуты ссылки
links_external - количество исходящих ссылок со ссылающейся страницы
link_type - тип входящей ссылки
* url_to - целевая страница
check - дата первого обнаружения
check
order опционально Сортировка:
asc - по возрастанию
desc - по убыванию
desc
complexFilter опционально Фильтрация данных, вводится в виде массивов [...] со следующими параметрами: 
1) field - тип фильтра, доступные фильтры:

url_from - ссылающаяся страница
anchor - анкор входящей ссылки
link_nofollow - атрибуты ссылки. Возможные значения: follow, nofollow, ugc, sponsored
links_external - количество исходящих ссылок со ссылающейся страницы
link_type - тип входящей ссылки. Возможные значения: text, redirect, iframe, form, canonical, rss, alternate, image
* url_to - целевая страница
check - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (01.01.2001)

2) compareType - условие фильтра:
* gt - больше, чем (числовое значение)
* lt - меньше, чем (числовое значение)
* gte - больше или равно (числовое значение)
* lte - меньше или равно (числовое значение)
* eq - точное соответствие (числовое или текстовое значение)
* neq - не соответствует (числовое или текстовое значение)
* between - между (числовое значение)
* contains - содержит (текстовое значение)
* notContains - не содержит (текстовое значение)
* startsWith - начинается на (текстовое значение)
* endsWith - заканчивается на (текстовое значение)

3) value - значение для фильтрации

3) value - значение для фильтрации

Быстрые фильтры:
additional_filters - на данные момент доступны следующие:
* no_subdomains - не учитывает ссылки с поддоменов анализируемого домена
* last_week - данные за последнюю неделю
* only_main_page - показывает только ссылки с главной страницы

Первые квадратные скобки перечисляют условия "ИЛИ". Вторые внутри первых - условия "И".
linkPerDomain опционально Режим получения данных:
* 0 - одна ссылка со страницы
* 1 - одна ссылка с домена
1

Параметры ответа
Параметр Описание
id Идентификатор запроса: соответствует id в запросе
result Содержит ответ
data Массив с данными ответа
url_from Страница, на которой найдена ссылка (ссылающаяся страница)
url_to Страница, на которую ведет ссылка (целевая страница)
nofollow Атрибуты ссылки. Если несколько - перечислены через запятую. Варианты: follow, nofollow, ugc, sponsored
link_type Тип ссылки. Варианты: href (text), image, redirect, frame, rss, alternate, form, canonical
links_ext Количество ссылок, исходящих со ссылающейся страницы
link_text Анкор ссылки (anchor)
first_seen Дата первого обнаружения ссылки
last_visited Дата последней проверки
date_del Дата, когда бот Serpstat перестал видеть ссылку
domain_rank Рейтинг ссылающегося домена - Serpstat Domain Rank
summary_info Объект с данными ответа
left_lines Оставшееся количество строк для тарифного плана
page Номер страницы
count Количество результатов в ответе
total Количество результатов по запросу
sort По каким данным происходит сортировка
order Данные отсортированы:
asc - по возрастанию
desc - по убыванию

Снятие лимитов API: по 1 лимиту за 1 строку результата в ответе. Часть ответа API, за которую снимается 1 лимит:

{
     "url_from": "https://zerotoscale.com/episode-150-content-creation-process-checklist-vacation-recap/",
     "url_to": "https://serpstat.com/",
     "nofollow": "follow",
     "link_type": "href",
     "links_ext": 12,
     "link_text": "SerpStat",
     "first_seen": "2019-09-05 05:51:46",
     "last_visited": "2019-12-11 18:41:42",
     "date_del": "2019-12-11 18:41:42"
}

Example
Request data:
{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getLostBacklinks",
 "params": {
     "query": "serpstat.com",
     "searchType": "domain",
     "sort": "url_from",
     "order": "desc",
     "page": 1,
     "size": 2,
     "linkPerDomain": 1,
     "complexFilter": [
            [
                {
                    "field": "url_from",
                    "compareType": "notContains",
                    "value": [
                        "7654765"
                    ]
                },
                {
                    "field": "link_nofollow",
                    "compareType": "contains",
                    "value": [
                        "follow",
                        "nofollow",
                        "ugc",
                        "sponsored"
                    ]
                },
                {
                    "field": "anchor",
                    "compareType": "notContains",
                    "value": [
                        "лопспрол"
                    ]
                },
                {
                    "field": "check",
                    "compareType": "lte",
                    "value": [
                        "1.1.2030"
                    ]
                },
                {
                    "field": "links_external",
                    "compareType": "between",
                    "value": [
                        "1",
                        "500"
                    ]
                }
            ],
            [
                {
                    "field": "links_external",
                    "compareType": "lte",
                    "value": [
                        "800"
                    ]
                },
                {
                    "additional_filters": "no_subdomains"
                },
                 {
                    "additional_filters": "only_main_page"
                },
                 {
                    "additional_filters": "last_week"
                }
            ]
        ]
  }
}
Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "url_from": "https://kinghead.wordpress.com",
                "url_to": "http://serpstat.com/",
                "nofollow": "follow",
                "link_type": "href",
                "links_ext": 13,
                "link_text": "Serpstat",
                "first_seen": "2020-11-11",
                "last_visited": "2021-09-16 09:36:15",
                "date_del": "2021-09-16 09:36:15",
                "domain_rank": 8
            }
        ],
        "summary_info": {
            "left_lines": 999803,
            "page": 1,
            "count": 1,
            "total": 1,
            "sort": "url_from",
            "order": "DESC"
        }
    }
}

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

Вы уверены?

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

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

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

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

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

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

Открыть чат технической поддержки