Domain History (domain_history)
API v3 methods will be unavailable from 12/31/2021. Use a similar API v4 method.
The domain_history method provides historical data on the number of keywords and visibility of the domain.
General request parameters and instructions for using Serpstat API
| Response parameters | |
| Parameter | Description |
| result | Contains the answer |
| domain | A domain of the analyzed site |
| keywords | Number of keywords found in the chosen search engine |
| traff | Estimated search traffic based on keyword positions and search volume |
| visible | Site visibility |
| visible_static | Dynamics of visibility since the last update |
| new_keywords | Number of new keywords since the last N-days monitoring |
| out_keywords | Number of lost keywords since the last N-days monitoring |
| rised_keywords | Number of keywords which positions of the domain have improved over the last N-days |
| down_keywords | Number of keywords which positions of the domain have dropped over the last N-days |
| ad_keywords | Number of keywords in PPC |
| ads | Number of the PPC ads |
| date | Verification date of a particular array element |
| status_msg | Response "Ok" or "Error" report on a successful or unsuccessful request |
| status_code | Response code "200" — successful request. Errors occur when credits are exceeded (number of simultaneous requests or account credits) |
| left_lines | API credits remaining |
Part of the API response for which you spend 1 credit:
{
"domain": "nike.com",
"keywords": 2603734,
"traff": 240307722,
"visible": 212.81692000000001,
"visible_static": 212.81692000000001,
"visible_mysql": 0,
"new_keywords": 32499,
"out_keywords": 37326,
"rised_keywords": 40518,
"down_keywords": 43717,
"ad_keywords": 1197,
"ads": 929,
"date": "2021-04-29"
},Request data:
api.serpstat.com/v3/domain_history?query=nike.com&token=XXX&se=g_us
Response data:
{
"result": [
{
"domain": "nike.com",
"keywords": 2603734,
"traff": 240307722,
"visible": 212.81692000000001,
"visible_static": 212.81692000000001,
"visible_mysql": 0,
"new_keywords": 32499,
"out_keywords": 37326,
"rised_keywords": 40518,
"down_keywords": 43717,
"ad_keywords": 1197,
"ads": 929,
"date": "2021-04-29"
},
{
"domain": "nike.com",
"keywords": 2613344,
"traff": 255497238,
"visible": 222.88057000000001,
"visible_static": 222.88057000000001,
"visible_mysql": 0,
"new_keywords": 40573,
"out_keywords": 30963,
"rised_keywords": 49642,
"down_keywords": 43635,
"ad_keywords": 1098,
"ads": 840,
"date": "2021-05-13"
}
],
"status_msg": "OK",
"status_code": 200,
"left_lines": 999030
}