Malicious pages-donors
The SerpstatBacklinksProcedure.getThreatsLinks method returns a list of links from malicious sites referring to the analyzed domain. The data set is similar to the Malicious sites report.
Use case: With the SerpstatBacklinksProcedure.getThreatsLinks method, find out what malicious pages are referring to your site and remove these backlinks.
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.getThreatsLinks | |
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 и "/". | |
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 | Sort: * lasingtupdate - date of the first detection * url_from - the URL of the malicious domain * url_to - target URL * 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) | |
order | optional | Order: * asc - in the ascending order * desc - in the descending order | desc |
linkPerDomain | optional | Data acquisition mode: * 0 - one link from the page * 1 - one link from the domain | |
complexFilter | optional | Data filtering, entered as arrays. Available columns: * threat_type - a type of vulnerability: * compareType - filter parameter: The first square brackets list the "OR" conditions. The second within the first are the "AND" conditions. |
Response parameters | |
Parameter | Description |
id | Response id corresponds the request id |
result | Contains the answer |
data | Array with data |
domain | Malicious domain |
link_from | Linking page |
link_to | Target page |
platform_type | Platform:
|
threat_type | Threat type:
|
last_update | Date of the last update |
summary_info | Object with data |
page | Page number |
total | Number of results for 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": "thevampireclubrus.blogspot.com",
"link_from": "http://thevampireclubrus.blogspot.com/2011/01/blog-post_09.html",
"link_to": "http://www.kinopoisk.ru/level/1/film/527662/",
"platform_type": [
"all_platforms"
],
"threat_type": [
"malware"
],
"lastupdate": "2020-12-02 08:48:52"
}
{
"id": 1,
"method": "SerpstatBacklinksProcedure.getThreatsLinks",
"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": "url_from",
"compareType": "contains",
"value": [
".com"
]
},
{
"field": "platform_type",
"compareType": "contains",
"value": [
"1"
]
},
{
"field": "threat_type",
"compareType": "contains",
"value": [
"1"
]
},
{
"field": "domain_from",
"compareType": "contains",
"value": [
"."
]
},
{
"field": "url_to",
"compareType": "contains",
"value": [
"."
]
}
]
]
}
}
{
"id": "1",
"result": {
"data": [
{
"domain": "thevampireclubrus.blogspot.com",
"link_from": "http://thevampireclubrus.blogspot.com/2011/01/blog-post_09.html",
"link_to": "http://www.kinopoisk.ru/level/1/film/527662/",
"platform_type": [
"all_platforms"
],
"threat_type": [
"malware"
],
"lastupdate": "2020-12-02 08:48:52"
},
{
"domain": "thevampireclubrus.blogspot.com",
"link_from": "http://thevampireclubrus.blogspot.com/2011/01/blog-post_09.html",
"link_to": "http://www.kinopoisk.ru/level/2/news/1446161/",
"platform_type": [
"all_platforms"
],
"threat_type": [
"malware"
],
"lastupdate": "2020-12-02 08:48:52"
}
],
"summary_info": {
"left_lines": 999826,
"page": 1,
"count": 2,
"total": 22,
"sort": "lastupdate",
"order": "DESC"
}
}
}