Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

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

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
}