Исходящие вредоносные домены (getOutThreats)
Метод getOutThreats возвращает список вредоносных доменов-акцепторов, на которые ведут ссылки с анализируемого домена, и информацию по ним. По набору данных аналогичен таблице отчета «Вредоносные сайты».
Общие параметры запроса и инструкция по использованию Serpstat API
Параметры запроса | |||
Параметр | Описание | По умолчанию | |
id | обязательно | Идентификатор запроса. Допускается ввод любого числового или строкового значения. | |
method | обязательно | Название метода API: SerpstatBacklinksProcedure.getOutThreats | |
params | обязательно | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы. | |
query | обязательно | Домен анализируемого сайта. Указываем домен без http / https и "/". | |
searchType | обязательно | Режим поиска: * domain_with_subdomains - домен с поддоменами * domain - только домен * URL - только URL |
|
page | опционально | Номер страницы. Допустимы числовые значения. | 1 |
size | опционально | Количество результатов. Допустимы числовые значения. | 100 |
sort | опционально | Сортировка данных: * lastupdate - дата первого обнаружения * domain_link - количество ссылок на домен * links_count - количество ссылок с домена * platform_type - платформа, для которой сайт представляет угрозу * threat_type - вид уязвимости |
lastupdate |
order | опционально | Направление сортировки: * asc - по возрастанию * desc - по убыванию |
desc |
complexFilter | опционально | Фильтрация данных, вводится в виде массивов. Доступные колонки: * domain_link - количество ссылок на домен * links_count - количество ссылок * platform_type - платформа, для которой сайт представляет угрозу: 1 - windows 2 - linux 3 - android 4 - OS X 5 - IOS 6 - любая ОС 7 - все ОС 8 - chrome OS * threat_type - вид уязвимости: * lastupdate - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (01.01.2001) Типы сравнения: |
|
linkPerDomain | опционально | Режим получения данных: * 0 - одна ссылка со страницы * 1 - одна ссылка с домена |
1 |
Параметры ответа | |
Параметр | Описание |
id | Идентификатор запроса |
result | Инкапсулирует в себе ответ |
data | Блок, содержащий список доменов и информацию по ним |
domain | Вредоносный домен |
domain_link | Страница, с которой ссылается домен |
links_count | Количество ссылающихся страниц |
platform_type |
Платформа:
|
threat_type |
Тип уязвимости:
|
lastupdate | Дата последней проверки |
summary_info | Инкапсулирует общую информацию по запросу |
page | Номер страницы |
sort | По какому полю происходит сортировка |
order | Данные отсортированы по возрастанию / убыванию |
total | Всего результатов по данному запросу |
count | Количество результатов, отображенных в ответе |
left_lines | Оставшийся лимит для тарифного плана |
Снятие лимитов API: по 1 лимиту за каждый домен. При отсутствии данных лимиты не снимаются.
Часть ответа, за которую снимается 1 лимит:
{
"domain": "thevampireclubrus.blogspot.com",
"domain_link": "http://thevampireclubrus.blogspot.com",
"links_count": 22,
"platform_type": [
"all_platforms"
],
"threat_type": [
"malware"
],
"lastupdate": "2020-12-02 08:48:52"
}
{
"id": 1,
"method": "SerpstatBacklinksProcedure.getOutThreats",
"params": {
"query": "kinopoisk.ru",
"searchType": "domain",
"sort": "lastupdate",
"order": "desc",
"page": 1,
"size": 2,
"linkPerDomain": 1,
"complexFilter": [
[
{
"field": "lastupdate",
"compareType": "gt",
"value": [
"29.09.2020"
]
},
{
"field": "domain_link",
"compareType": "contains",
"value": [
".ru"
]
},
{
"field": "links_count",
"compareType": "gte",
"value": [
"1"
]
},
{
"field": "platform_type",
"compareType": "contains",
"value": [
"1"
]
},
{
"field": "threat_type",
"compareType": "contains",
"value": [
"1"
]
}
]
]
}
}
{
"id": "1",
"result": {
"data": [
{
"domain": "lexxlight.ru",
"domain_link": "http://lexxlight.ru",
"links_count": 1,
"platform_type": [
"all_platforms"
],
"threat_type": [
"malware"
],
"lastupdate": "2020-09-29 17:48:34"
}
],
"summary_info": {
"left_lines": 999817,
"page": 1,
"count": 1,
"total": 1,
"sort": "lastupdate",
"order": "DESC"
}
}
}