Malicious domains-acceptors

The SerpstatBacklinksProcedure.getOutThreats method returns a list of malicious domains referring to the analyzed domain and information on them. The data set is similar to the Malicious sites report.

Use case: With the SerpstatBacklinksProcedure.getOutThreats method, check which resources have malicious links from the target site to make sure that your site is not among them.

General request parameters and instructions for using Serpstat API

Request parameters
Parameter		Description	Default
id	required	A request id: the response contains the same id. Enter any number (number) or text (string) value
method	required	API method name: SerpstatBacklinksProcedure.getOutThreats
params	required	The object with parameters {...}, it lists all the following parameters and arrays [...]
query	required	A domain of the analyzed site. Specify the domain without HTTP, HTTPS, and "/"
searchType	required	Search type: * domain - only domain (site.com) * domain_with_subdomains - domain with subdomains (subdomain.site.com)
page	optional	A page number (number value)	1
size	optional	A number of results (number value)	100
sort	optional	Sorting: * lastupdate - date of the first detection * domain_link - number of links to the domain * links_count - number of links from the domain * platform_type - the platform for which the site is a threat: 1 - windows 2 - linux 3 - android 4 - OS X 5 - IOS 6 - any OS 7 - all OS 8 - chrome OS * threat_type - a type of vulnerability: 1 - malware 2 - social engineering 3 - unwanted software 4 - potentially harmful application * lastupdate - link detection date. Value format: DD.MM.YYYY (01.01.2001)	lastupdate
order	optional	Order: * asc - in the ascending order * desc - in the descending order	desc
complexFilter	optional	Data filtering, entered as arrays [...] * field - filter parameter Available filtering: * lastupdate - date of the first detection * domain_link - number of links to the domain * links_count - number of links from the domain * platform_type - the platform for which the site is a threat: 1 - windows 2 - linux 3 - android 4 - OS X 5 - IOS 6 - any OS 7 - all OS 8 - chrome OS * threat_type - a type of vulnerability: 1 - malware 2 - social engineering 3 - unwanted software 4 - potentially harmful application * lastupdate - link detection date. Value format: DD.MM.YYYY (01.01.2001) * compareType - filter parameter: * gt - greater than (number value) * lt - less than (number value) * gte - greater than or equal (number value) * lte - less than or equal (number value) * eq - exact match (number or text value) * neq - does not meet the requirement (number or text value) * between - between (number value) * contains - contains (text value) * notContains - does not contain (text value) * startsWith - starts with (text value) * endsWith - ends with (text value) * value - filter value The first square brackets list the "OR" conditions. The second within the first are the "AND" conditions.
linkPerDomain	optional	Data acquisition mode: * 0 - one link from the page * 1 - one link from the domain	1

Response parameters
Parameter	Description
id	Response id corresponds the request id
result	Contains the answer
data	Array with data
domain	Malicious domain
domain_link	Number of links to the domain
links_count	Number of links from the domain
platform_type	Platform: windows; Linux; android; OS X; IOS; any OS; all OS; chrome OS.
threat_type	Threat type: malware; social engineering; unwanted software; potentially harmful application.
last_update	Date of the last update
summary_info	Object with data
page	Page number
total	Number of results for the request
count	Number of results in this answer
left_lines	Left credits of lines for your pricing plan
sort	What data are sorted by
order	Data sorted: * asc - in the ascending order * desc - in the descending order

API credits are spent at 1 credit for each domain. If data are absent, the credits are not charged. Part of the API response for which you spend 1 credit:

{
     "domain": "lexxlight.ru",
     "domain_link": "http://lexxlight.ru",
     "links_count": 1,
     "platform_type": [
         "all_platforms"
     ],
     "threat_type": [
         "malware"
     ],
     "lastupdate": "2020-09-29 17:48:34"
}

Example

Request data:

{
 "id": 1,
 "method": "SerpstatBacklinksProcedure.getOutThreats",
 "params": {
     "query": "kinopoisk.ru",
     "searchType": "domain",
     "sort": "lastupdate",
     "order": "desc",
     "page": 1,
     "size": 2,
     "linkPerDomain": 1,
     "complexFilter": [
            [
                {
                    "field": "lastupdate",
                    "compareType": "gt",
                    "value": [
                        "29.09.2020"
                    ]
                },
                {
                    "field": "domain_link",
                    "compareType": "contains",
                    "value": [
                        ".ru"
                    ]
                },
                {
                    "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": "lexxlight.ru",
                "domain_link": "http://lexxlight.ru",
                "links_count": 1,
                "platform_type": [
                    "all_platforms"
                ],
                "threat_type": [
                    "malware"
                ],
                "lastupdate": "2020-09-29 17:48:34"
            }
        ],
        "summary_info": {
            "left_lines": 999817,
            "page": 1,
            "count": 1,
            "total": 1,
            "sort": "lastupdate",
            "order": "DESC"
        }
    }
}