Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

External lost links (getLostOutlinks)

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 required 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
* 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
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"
}

Example
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": "lastupdate",
                    "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"
        }
    }
}