External lost links
The getLostOutlinks method gives you a list of lost external links of a site you analyze. The data set is similar to the Lost external links report.
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.getLostBacklinks | |
| 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 | optional | Search type: * domain - only domain (site.com) * domain_with_subdomains - domain with subdomains (subdomain.site.com) * URL - the specific URL (site.com/path/) * part_url - URL starts with (site.com/path/*) | |
| page | optional | A page number (number value) | 1 |
| size | optional | A number of results (number value) | 100 |
| sort | optional | Sorting: * url_from - the referring page * anchor - the anchor of the external link * link_nofollow - link attributes * links_external - a number of outgoing links from the referring page * link_type - the type of external link * url_to - a landing page * lastupdate - date of the last check | 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: * url_from - the referring page * anchor - the anchor of the external link * link_nofollow - link attributes. Possible values: follow, nofollow, ugc, sponsored * links_external - the number of external links from the referring page * link_type - the type of the external link. Possible values: text, redirect, iframe, form, canonical, rss, alternate, image * url_to - a landing page * check - link detection date. Value format: DD.MM.YYYY (01.01.2001) * compareType - filter parameter: 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 |
| url_from | Linking page |
| url_to | Target page |
| nofollow | Link attributes. If several are listed, they're separated by commas. Options: follow, nofollow, UGC, sponsored |
| link_type | Link type. Options: href, image, redirect, frame, rss, alternate, form, canonical |
| links_ext | Number of external links from the referring page |
| link_text | Link anchor |
| first_seen | Link detection date |
| last_visited | The last date of crawling |
| date_del | The last date of the link marked as lost by Serpstat bot |
| summary_info | Object with data |
| page | Page number |
| total | Number of results for request |
| count | Number of results in this answer |
| left_lines | Left credit 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 credits per line. Part of the API response for which you spend 1 credit:
{
"url_from": "https://zerotoscale.com/episode-150-content-creation-process-checklist-vacation-recap/",
"url_to": "https://serpstat.com/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 12,
"link_text": "SerpStat",
"first_seen": "2019-09-05 05:51:46",
"last_visited": "2019-12-11 18:41:42",
"date_del": "2019-12-11 18:41:42"
}Request data:
{
"id": 1,
"method": "SerpstatBacklinksProcedure.getLostOutlinks",
"params": {
"query": "serpstat.com",
"searchType": "domain",
"sort": "url_from",
"order": "desc",
"page": 1,
"size": 2,
"linkPerDomain": 1,
"complexFilter": [
[
{
"field": "url_from",
"compareType": "notContains",
"value": [
"7654765"
]
},
{
"field": "link_nofollow",
"compareType": "contains",
"value": [
"follow",
"nofollow",
"ugc",
"sponsored"
]
},
{
"field": "anchor",
"compareType": "notContains",
"value": [
"лопспрол"
]
},
{
"field": "check",
"compareType": "lte",
"value": [
"1.1.2030"
]
},
{
"field": "links_external",
"compareType": "between",
"value": [
"1",
"500"
]
}
],
[
{
"field": "links_external",
"compareType": "lte",
"value": [
"800"
]
}
]
]
}
}Response data:
{
"id": "1",
"result": {
"data": [
{
"url_from": "https://serpstat.com/use-cases/?category=seo",
"url_to": "http://netpeak.net/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 10,
"link_text": "Netpeak",
"first_seen": "2020-11-27",
"last_visited": "2021-03-13 22:18:02",
"date_del": "2021-03-13 22:18:02"
},
{
"url_from": "https://serpstat.com/use-cases/?category=ppc",
"url_to": "http://netpeak.net/",
"nofollow": "follow",
"link_type": "href",
"links_ext": 10,
"link_text": "Netpeak",
"first_seen": "2020-11-27",
"last_visited": "2021-03-13 22:17:49",
"date_del": "2021-03-13 22:17:49"
}
],
"summary_info": {
"left_lines": 999990,
"page": 1,
"count": 2,
"total": 3437,
"sort": "url_from",
"order": "DESC"
}
}
}