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.
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 | 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.getBacklinksChangesHistory |
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: 000webhostapp.com | |
searchType | Search modes for analysis | string | no | domain_with_subdomains | domain - domain only (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.
{
"id": 1,
"method": "SerpstatBacklinksProcedure.getBacklinksChangesHistory",
"params": {
"query": "serpstat.com",
"searchType": "domain_with_subdomains"
}
}
{
"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
}
}
}