Вредоносные страницы-доноры

Метод SerpstatBacklinksProcedure.getThreatsLinks возвращает список ссылок с вредоносных доменов, ведущих на анализируемый домен, и информацию по ним. Аналогичен отчету «Вредоносные сайты».

Ссылки с вредоносных доменов, ведущих на анализируемый домен

Пример использования: С помощью метода SerpstatBacklinksProcedure.getThreatsLinks узнайте, какие вредоносные сайты ссылаются на ваш сайт, и удалите эти обратные ссылки.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор.	int/string	да		любое текстовое или числовое значение Например: 1, test
method	Название метода API	string	да		SerpstatBacklinksProcedure.getThreatsLinks
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]		да
query	Домен анализируемого сайта. Указываем домен без http / https и "/".	string	да		Текстовое значение анализируемого домена. Например: 000webhostapp.com
searchType	Режимы поиска для анализа	string	да	domain_with_subdomains	domain - только домен (site.com) domain_with_subdomains - домен с поддоменами(subdomain.site.com)
page	Номер страницы (числовое значение)	int	нет	1	любое числовое значение
size	Количество результатов (числовое значение)	int	нет	100	числовое значение в диапазоне 1-1000
order	Направление сортировки	string	нет	desc	* asc - по возрастанию * desc - по убыванию
sort	Сортировка данных	string	нет	lastupdate	* lastupdate - дата первого обнаружения * url_from - страница, на которой находятся ссылки * platform_type - платформа, для которой сайт представляет угрозу: 1 - windows 2 - linux 3 - android 4 - OS X 5 - IOS 6 - любая OC 7 - все OC 8 - chrome OS * threat_type - вид уязвимости: 1 - вредоносное ПО 2 - социальная инженерия 3 - нежелательное ПО 4 - потенциально вредоносное ПО * url_to - целевая страница

Параметры фильтрации

Параметр

Описание

complexFilter

Фильтрация данных, вводится в виде массивов [...].
* field - тип фильтра
Доступные фильтры:
* url_from - страница, на которой находится ссылки
* domain_from - домен, который ссылается
* url_to - целевая страница
* platform_type - платформа, для которой сайт представляет угрозу:
1 - windows
2 - linux
3 - android
4 - OS X
5 - IOS
6 - любая OC
7 - все OC
8 - chrome OS

* threat_type - вид уязвимости:
1 - вредоносное ПО
2 - социальная инженерия
3 - нежелательное ПО
4 - потенциально вредоносное ПО

* lastupdate - дата первого обнаружения. Формат значения: ДД.ММ.ГГГГ (01.01.2001)

* compareType - условие фильтра:
* gt - больше, чем (числовое значение)
* lt - меньше, чем (числовое значение)
* gte - больше или равно (числовое значение)
* lte - меньше или равно (числовое значение)
* eq - точное соответствие (числовое или текстовое значение)
* neq - не соответствует (числовое или текстовое значение)
* between - между (числовое значение)
* contains - содержит (текстовое значение)
* notContains - не содержит (текстовое значение)
* startsWith - начинается на (текстовое значение)
* endsWith - заканчивается на (текстовое значение)

* value - значение для фильтрации

Первые квадратные скобки перечисляют условия "ИЛИ". Вторые внутри первых - условия "И".

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит ответ
data	Массив с данными ответа
domain	Вредоносный домен
link_from	URL вредоносной страницы
link_to	Страница, на которую ведет ссылка
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	Объект с данными ответа
left_lines	Оставшееся количество строк для тарифного плана
page	Номер страницы
count	Количество результатов в ответе
total	Всего результатов по запросу
sort	Данные для сортировки
order	Данные отсортированы: * asc - по возрастанию * desc - по убыванию

Снятие лимитов API: по 1 лимиту за каждую ссылку. При отсутствии данных лимиты не снимаются.

{
     "domain": "thevampireclubrus.blogspot.com",
     "link_from": "http://thevampireclubrus.blogspot.com/2011/01/blog-post_09.html",
     "link_to": "http://www.kinopoisk.ru/level/1/film/527662/",
     "platform_type": [
         "all_platforms"
     ],
     "threat_type": [
         "malware"
     ],
     "lastupdate": "2020-12-02 08:48:52"
}

Example

Request data:

{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getThreatsLinks",
 "params": {
     "query": "kinopoisk.ru",
     "searchType": "domain",
     "sort": "lastupdate",
     "order": "desc",
     "page": 1,
     "size": 2,
     "linkPerDomain": 1,
     "complexFilter": [
            [
                {
                    "field": "lastupdate",
                    "compareType": "gt",
                    "value": [
                        "25.09.2020"
                    ]
                },
                {
                    "field": "url_from",
                    "compareType": "contains",
                    "value": [
                        ".com"
                    ]
                },
                {
                    "field": "platform_type",
                    "compareType": "contains",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "threat_type",
                    "compareType": "contains",
                    "value": [
                        "1"
                    ]
                },
                {
                    "field": "domain_from",
                    "compareType": "contains",
                    "value": [
                        "."
                 ]
                },
                {
                    "field": "url_to",
                    "compareType": "contains",
                    "value": [
                        "."
                 ]
                } 
            ]
        ]
  }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "thevampireclubrus.blogspot.com",
                "link_from": "http://thevampireclubrus.blogspot.com/2011/01/blog-post_09.html",
                "link_to": "http://www.kinopoisk.ru/level/1/film/527662/",
                "platform_type": [
                    "all_platforms"
                ],
                "threat_type": [
                    "malware"
                ],
                "lastupdate": "2020-12-02 08:48:52"
            },
            {
                "domain": "thevampireclubrus.blogspot.com",
                "link_from": "http://thevampireclubrus.blogspot.com/2011/01/blog-post_09.html",
                "link_to": "http://www.kinopoisk.ru/level/2/news/1446161/",
                "platform_type": [
                    "all_platforms"
                ],
                "threat_type": [
                    "malware"
                ],
                "lastupdate": "2020-12-02 08:48:52"
            }
        ],
        "summary_info": {
            "left_lines": 999826,
            "page": 1,
            "count": 2,
            "total": 22,
            "sort": "lastupdate",
            "order": "DESC"
        }
    }
}