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

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

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

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

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

Параметри запиту
Параметр	Опис	Тип даних	Обов'язковий	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь містить цей же ідентифікатор. Введення числового (number) або текстового (string) значення	int/string	так		будь-яке текстове або числове значення Наприклад: 1, test
method	Назва методу API	string	так		SerpstatBacklinksProcedure.getOutThreatsLinks
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 - дата першого виявлення * 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 - потенційно шкідливе ПЗ

Параметри фільтрації
Параметр		Опис
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 - закінчується на (текстове значення) Перші квадратні дужки перераховують умови "АБО". Другі всередині перших - умови "І".

Параметри відповіді
Параметр	Опис
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"
        }
    }
}