Domain History (domain_history)

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

Example

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
}