Потерянные ссылки (getLostBacklinks)
Метод getLostBacklinks возвращает список утерянных ссылок на анализируемый сайт, по набору данных аналогичен таблице отчета «Потерянные ссылки». Показатели, потерявшие актуальность, не убираются из метода для сохранения обратной совместимости.
Общие параметры запроса и инструкция по использованию Serpstat API
| Параметры запроса | |||
| Параметр | Описание | По умолчанию | |
| id | обязательно | Идентификатор запроса. Допускается ввод любого числового или строкового значения. | |
| method | обязательно | Название метода API: SerpstatBacklinksProcedure.getLostBacklinks | |
| params | обязательно | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы. | |
| query | обязательно | Домен анализируемого сайта. Указываем домен без http / https и "/". | |
| searchType | обязательно | Режим поиска: * domain_with_subdomains - домен с поддоменами * domain - только домен * 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 | Дата последней проверки |
| str | Serpstat Trust Rank (неактуально) |
| spr | Serpstat Page Rank (неактуально) |
| organic | Органические или платные ссылки (неактуально) |
| ip | Количество ссылающихся IP (неактуально) |
| redirect | Ссылки с редиректами (неактуально) |
| noindex | Ссылки с атрибутом noindex (неактуально) |
| 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"
}
}
}