External lost links

The SerpstatBacklinksProcedure.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.

a list of lost external links of a site you analyze

Use case: with the SerpstatBacklinksProcedure.getLostOutlinks method, check what links your site has lost to find out why they were lost and try to establish these links again.

General request parameters and instructions for using Serpstat API

Request parameters
Parameter	Description	Type	Required	Default value	Value options
id	A request id: the response contains the same id. Enter any number (number) or text (string) value	int/string	yes		Text or number value. For example: 1, test
method	API method name	string	yes		SerpstatBacklinksProcedure.getLostOutlinks
params	The object with parameters {...}, it lists all the following parameters and arrays [...]		yes
query	Domain of the analyzed site. Specify the domain without http / https and «/»	string	yes		The text value of the domain being analyzed. For example: serpstat.com
searchType	Search modes for analysis	string	yes		* 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	A page number (number value)	int	no	1	any number value
size	A number of results (number value)	int	no	100	number value in the range of 1-1000
sort	Sorting the results	string	no	lastupdate	* 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
order	Order	string	no	desc	* asc - in the ascending order * desc - in the descending order

Filter conditions parameters

Parameter

Description

complexFilter

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:
* 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.

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": "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"
        }
    }
}