Switch to english interface?

Вредоносные домены-доноры

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

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

Параметры запроса
Параметр Описание По умолчанию
id обязательно Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.
method обязательно Название метода API: SerpstatBacklinksProcedure.getThreats
params обязательно Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...].
query обязательно Домен анализируемого сайта. Указываем домен без http / https и "/".
searchType обязательно Режимы поиска для анализа:
* domain - только домен (site.com)
* domain_with_subdomains - домен, включающий поддомен (poddomen.site.com)
sort опционально Сортировка данных:
* lastupdate -  дата первого обнаружения
* domain_link - количество ссылок на домен
* links_count - количество ссылок с домена
* 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
order опционально Направление сортировки:
* asc - по возрастанию
* desc - по убыванию
desc
page опционально Номер страницы (числовое значение) 1
size опционально Количество результатов (числовое значение) 100
linkPerDomain опционально Режим получения данных:
* 0 - одна ссылка со страницы
* 1 - одна ссылка с домена
1
complexFilter опционально Фильтрация данных, вводится в виде массивов [...].
* field - тип фильтра

Доступные фильтры:
* domain_link - количество ссылок на домен
* links_count - количество ссылок
* 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 Вредоносный домен
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 Данные отсортированы:
asc - по возрастанию
desc - по убыванию
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
Request data:
{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getThreats",
 "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": "domain_link",
                    "compareType": "contains",
                    "value": [
                        ".com"
                    ]
                },
                {
                    "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": "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"
            }
        ],
        "summary_info": {
            "left_lines": 999836,
            "page": 1,
            "count": 1,
            "total": 1,
            "sort": "lastupdate",
            "order": "DESC"
        }
    }
}

Поделитесь статьей с вашими друзьями

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

Открыть чат технической поддержки