Потерянные ссылки (getLostBacklinks)
Метод getLostBacklinks возвращает список утерянных ссылок на анализируемый сайт, по набору данных аналогичен таблице отчета «Потерянные ссылки».
Общие параметры запроса и инструкция по использованию Serpstat API
| Параметры запроса | |||
| Параметр | Описание | По умолчанию | |
| id | обязательно | Идентификатор запроса. Допускается ввод любого числового или строкового значения. | |
| method | обязательно | Название метода API: SerpstatBacklinksProcedure.getLostBacklinks | |
| params | обязательно | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы. | |
| query | обязательно | Домен анализируемого сайта. Указываем домен без http / https и "/". | |
| searchType | обязательно | Режим поиска: * domain_with_subdomains - домен с поддоменами * domain - только домен * URL - только URL * part_url - URL начинается с |
|
| page | опционально | Номер страницы. Допустимы числовые значения. | 1 |
| size | опционально | Количество результатов. Допустимы числовые значения. | 100 |
| sort | опционально | Сортировка данных: * url_from - ссылающаяся страница * anchor - анкор входящей ссылки * link_nofollow - атрибуты ссылки * links_external - количество исходящих ссылок со ссылающейся страницы * link_type - тип входящей ссылки * url_to - целевая страница * lastupdate - дата первого обнаружения |
lastupdate |
| order | опционально | Направление сортировки: * asc - по возрастанию * desc - по убыванию |
desc |
| complexFilter | опционально | Фильтрация данных, вводится в виде массивов. Доступные колонки: * url_from - ссылающаяся страница * anchor - анкор входящей ссылки * link_nofollow - атрибуты ссылки. Возможные значения: follow, nofollow, ugc, sponsored * links_external - количество исходящих ссылок со ссылающейся страницы * link_type - тип входящей ссылки. Возможные значения: text, redirect, iframe, form, canonical, rss, alternate, image * url_to - целевая страница * lastupdate - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (01.01.2001) Типы сравнения: * gt - больше, чем. Допустимы числовые значения * lt - меньше, чем. Допустимы числовые значения * gte - больше или равно. Допустимы числовые значения * lte - меньше или равно. Допустимы числовые значения * eq - точное соответствие. Допустимы числовые и строковые значения * neq - не соответствует. Допустимы числовые и строковые значения * between - между. Допустимы числовые значения * contains - содержит. Допустимы строковые значения * notContains - не содержит. Допустимы строковые значения * startsWith - начинается на. Допустимы строковые значения * endsWith - заканчивается на. Допустимы строковые значения Первые квадратные скобки перечисляют условия "ИЛИ". Вторые внутри первых - условия "И". |
|
| linkPerDomain | опционально | Режим получения данных: * 0 - одна ссылка со страницы * 1 - одна ссылка с домена |
1 |
| Параметры ответа | |
| Параметр | Описание |
| 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 перестал видеть ссылку |
| summary_info | Объект с данными |
| left_lines | Оставшийся лимит количества строк для тарифного плана |
| page | Номер страницы |
| count | Количество результатов в данном ответе |
| total | Количество результатов всего по запросу |
| sort | По каким данным происходит сортировка |
| order | Направление сортировки: по возрастанию / убыванию |
Снятие лимитов 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"
}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": "lastupdate",
"compareType": "lte",
"value": [
"1.1.2030"
]
},
{
"field": "links_external",
"compareType": "between",
"value": [
"1",
"500"
]
}
],
[
{
"field": "links_external",
"compareType": "lte",
"value": [
"800"
]
}
]
]
}
}Response data:
{
"id": "1",
"result": {
"data": [
{
"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"
},
{
"url_from": "https://zen.yandex.ru/media/oxjornal/poleznye-instrumenty-i-saity-dlia-seospecialista-59f08c339d5cb307089b57bd",
"url_to": "https://serpstat.com/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 14,
"link_text": "Serpstat",
"first_seen": "2019-03-20 12:08:14",
"last_visited": "2019-11-01 16:03:36",
"date_del": "2019-11-01 16:03:36"
}
],
"summary_info": {
"left_lines": 999995,
"page": 1,
"count": 2,
"total": 1440,
"sort": "url_from",
"order": "DESC"
}
}
}