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

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

Шкідливі домени-донори (getThreats)

Метод 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 - потенційно шкідливе ПЗ
order опціонально Напрямок сортування:
* asc - по зростанню
* desc - по спадаючій
page опціонально Номер сторінки (числове значення)
size опціонально Кількість результатів (числове значення) 100
complexFilter опціонально

Фільтрація даних, вводиться у вигляді масивів [...].
* field - тип фільтру
Доступні фільтри:

* 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 - дата першого виявлення. Формат значення: ДД.ММ.РРРР (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 Кількість сторінок, які посилаються
platfrom_type

Платформа:

  • windows;
  • linux;
  • android;
  • OS X;
  • IOS;
  • будь-яка ОС;
  • усі ОС;
  • 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"
        }
    }
}

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

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

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

Або 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
Повідомлення
Необов'язково

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

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

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