Входящие потерянные ссылки (getLostBacklinks)
]Метод 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 - целевая страница * lastupdate - дата первого обнаружения |
lastupdate |
| 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 - целевая страница * lastupdate - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (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"
}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"
}
}
}