Шкідливі сторінки-акцептори

Метод SerpstatBacklinksProcedure.getOutThreatsLinks повертає список посилань зі шкідливих доменів, які ведуть на аналізований домен, і інформацію для них. За набором даних аналогічний таблиці звіту «Шкідливі сайти».

Список посилань зі шкідливих доменів, які ведуть на аналізований домен

Приклад використання: За допомогою метода SerpstatBacklinksProcedure.getOutThreatsLinks перевірте, на які сторінки ведуть шкідливі посилання з цільового сайту, щоб переконатися, що серед таких ресурсів немає вашого сайту.

Загальні параметри запиту та інструкція по використанню Serpstat API

Параметри запиту
Параметр		Опис	За замовчувчанням
id	обов'язково	Ідентифікатор запиту: відповідь містить цей же ідентифікатор. Введення числового (number) або текстового (string) значення.
method	обов'язково	Назва методу API: SerpstatBacklinksProcedure.getOutThreatsLinks
params	обов'язково	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри і масиви [...]
query	обов'язково	Домен аналізованого сайту. Вказуємо домен без http / https і "/".
searchType	обов'язково	Режим пошуку: * domain - тільки домен (site.com) * domain_with_subdomains - домен з піддоменами (subdomain.site.com)
page	опціонально	Номер сторінки (числове значення)	1
size	опціонально	Кількість результатів (числове значення)	100
sort	опціонально	Сортування даних: * lastupdate - дата першого виявлення * 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
order	опціонально	Напрямок сортування: * asc - по зростанню * desc - по спадаючій	desc
complexFilter	опціонально	Фільтрація даних, вводиться у вигляді масивів [...]. * field - тип фільтру Доступні фільтри: * lastupdate - дата першого виявлення * url_from - сторінка, на якій знаходиться посилання * url_to - цільова сторінка * platform_type - платформа, для якої сайт представляє загрозу: 1 - windows 2 - linux 3 - android 4 - os x 5 - ios 6 - будь-яка оc 7 - усі oc 8 - chrome os * threat_type - вид уразливості: 1 - шкідливе ПЗ 2 - соціальна інженерія 3 - небажане ПЗ 4 - потенційно шкідливе ПЗ * compareType - умова фільтру: * gt - більше, ніж (числове значення) * lt - менше, ніж (числове значення) * gte - більше або дорівнює (числове значення) * lte - менше або дорівнює (числове значення) * eq - точна відповідність (числове та текстове значення) * neq - НЕ відповідає (числове та текстове значення) * between - між (числове значення) * contains - містить (текстове значення) * notContains - не містить (текстове значення) * startsWith - починається на (текстове значення) * endsWith - закінчується на (текстове значення) Перші квадратні дужки перераховують умови "АБО". Другі всередині перших - умови "І".
linkPerDomain	опціонально	Режим отримання даних: * 0 - одне посилання зі сторінки * 1 - одне посилання з домену	1

Параметри відповіді
Параметр	Опис
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	Об'єкт з даними
page	Номер сторінки
order	Дані відсортовані: * asc - за зростанням * desc - за спаданням
sort	За якими даними відбувається сортування
total	Кількість результатів за запитом (всього)
count	Кількість результатів в даній відповіді
left_lines	Ліміт рядків для тарифного плану, що залишився

Зняття лімітів API: по 1 ліміту за кожну посилання. При відсутності даних ліміти не знімаються. Частина відповіді, за яку знімається 1 ліміт:

{
     "domain": "lexxlight.ru",
     "link_from": "https://www.kinopoisk.ru/article/3047941/",
     "link_to": "http://www.lexxlight.ru/interview/Jeff_Hirschfield_april2001_eng.html",
     "platform_type": [
         "all_platforms"
     ],
     "threat_type": [
         "malware"
     ],
     "lastupdate": "2020-09-29 17:48:34"
}

Example

Request data:

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

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "lexxlight.ru",
                "link_from": "https://www.kinopoisk.ru/article/3047941/",
                "link_to": "http://www.lexxlight.ru/interview/Jeff_Hirschfield_april2001_eng.html",
                "platform_type": [
                    "all_platforms"
                ],
                "threat_type": [
                    "malware"
                ],
                "lastupdate": "2020-09-29 17:48:34"
            }
        ],
        "summary_info": {
            "left_lines": 999816,
            "page": 1,
            "count": 1,
            "total": 1,
            "sort": "url_from",
            "order": "DESC"
        }
    }
}