Исходящие вредоносные домены (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 - вид уязвимости: 1 - вредоносное ПО 2 - социальная инженерия 3 - нежелательное ПО 4 - потенциально вредоносное ПО * lastupdate - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (01.01.2001) Типы сравнения: * gt - больше, чем. Допустимы числовые значения * lt - меньше, чем. Допустимы числовые значения * gte - больше или равно. Допустимы числовые значения * lte - меньше или равно. Допустимы числовые значения * eq - точное соответствие. Допустимы числовые и строковые значения * neq - не соответствует. Допустимы числовые и строковые значения * between - между. Допустимы числовые значения * contains - содержит. Допустимы строковые значения * notContains - не содержит. Допустимы строковые значения * startsWith - начинается на. Допустимы строковые значения * endsWith - заканчивается на. Допустимы строковые значения Первые квадратные скобки перечисляют условия "ИЛИ". Вторые внутри первых - условия "И".
linkPerDomain	опционально	Режим получения данных: * 0 - одна ссылка со страницы * 1 - одна ссылка с домена	1

Параметры ответа
Параметр	Описание
id	Идентификатор запроса
result	Инкапсулирует в себе ответ
data	Блок, содержащий список доменов и информацию по ним
domain	Вредоносный домен
domain_link	Страница, с которой ссылается домен
links_count	Количество ссылающихся страниц
platform_type	Платформа: windows; linux; android; OS X; IOS; любая OC; все OC; chrome OS.
threat_type	Тип уязвимости: malware — вредоносное ПО; social engineering — социальная инженерия; unwanted software — нежелательное ПО; potentially harmful application — потенциально вредоносное ПО.
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"
            }

Example PHP Python

Request data:

{
 "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"
                    ]
                }
            ]   
        ]
  }
}

Response data:

{
    "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"
        }
    }
}