Backlinks dynamics

The SerpstatBacklinksProcedure.getBacklinksChangesHistory method returns the history of found and lost backlinks for the analyzed site. The data set is similar to the graphs "Linking page dynamics" and "New and lost backlinks" charts in the Summary report.

linking pages dynamics

New and lost backlinks

Use case: With the SerpstatBacklinksProcedure.getBacklinksChangesHistory method, use the history of found and lost inbound links to determine changes in the link weight of your site or your competitors' site to further shape your link building strategy.

General request parameters and instructions for using Serpstat API

Request parameters
Parameter		Description
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.getBacklinksChangesHistory
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)

Response parameters
Parameter	Description
id	Response id corresponds the request id
result	Contains the answer
data	Array with data
date	Update date
lost_links	Number of lost backlinks
new_links	Number of new backlinks
summary_info	Object with data
left_lines	Left credits of lines for your pricing plan
count	Number of results in this answer
page	Page number
total	Number of results for the request (not used in this procedure)
sort	What data are sorted by (not used in this procedure)
order	Data sorted (not used in this procedure)

1 request charges 1 API credit.

Example

Request data:

{
    "id": 1,
    "method": "SerpstatBacklinksProcedure.getBacklinksChangesHistory",
    "params": {
        "query": "serpstat.com",
        "searchType": "domain_with_subdomains"
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "date": "2021-06-07",
                "lost_links": 759,
                "new_links": 434
            },
            {
                "date": "2021-06-14",
                "lost_links": 1,
                "new_links": 9
            },
            {
                "date": "2021-06-21",
                "lost_links": 0,
                "new_links": 10
            },
            {
                "date": "2021-06-28",
                "lost_links": 5,
                "new_links": 3074
            },
            {
                "date": "2021-07-05",
                "lost_links": 2,
                "new_links": 3414
            }
        ],
        "summary_info": {
            "left_lines": 999997,
            "page": 1,
            "count": 108,
            "total": null,
            "sort": null,
            "order": null
        }
    }
}