Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

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

Метод 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"
        }
    }
}

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

Вхід Реєстрація

Ви вичерпали ліміт запитів.

Або email
Забыли пароль?
Або email
Optional
Повернутися до авторизації

Не хвилюйтеся! Лише заповніть поле з вашою email адресою і ми вишлемо вам листа для відновлення паролю.

Ви впевнені?

Awesome!

To complete your registration you need to enter your phone number

Назад

Ми надіслали код підтвердження на ваш номер телефону

Your phone Resend code Залишилося запитів

Щось пішло не так.

Зв'яжіться з нашою службою підтримки
Або підтвердіть регістарціі за допомогою Телеграм бота Перейдіть за цим посиланням
Виберіть проєкт, по якому хочете отримувати дані

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

Наш фахівець зв'яжеться з вами і за підсумком запропонує відповідний варіант, який може включати персональну демонстрацію, пробний період, навчальні статті та записи вебінарів, консультацію фахівця, а також комфортні умови для старту використання Serpstat.

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Покращити план

Експорт недоступний для вашого тарифного плану. Вам необхідно поліпшити свій тариф до Lite або вище, щоб отримати доступ до інструменту. Детальніше

Sign Up Free

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Запрошення
Просмотр Редактирование

E-mail
Повідомлення
Необов'язково
E-mail
Повідомлення
Необов'язково

У вас закінчилися ліміти

Ви досягли ліміту на кількість створених проєктів і більше не можете створювати нові проєкти. Збільште ліміти або видаліть існуючі проєкти.

Я хочу більше лімітів
Відкрити чат технічної підтримки