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

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

By using the website, you agree to our Privacy policy

Sign in Sign Up

Domain History (domain_history)


This report provides you with the historical data on a domain’s number of keywords and visibility. 

Metrics Description
result Encapsulates the answer
visible_static Visibility
visible Site visibility
domain Domain
keywords The number of keywords found in the chosen search engine
ads Number of Ads as of ""date""
ad_keywords Number of keywords in ads
new_keywords Number of new keywords
out_keywords Number of keywords which were lost by a domain in the last N-days
rised_keywords Number of domain's keywords which positions have improved over the last N-days
down_keywords Number of domain's keywords which positions have dropped over the last N-days
date Verification date of a particular array element
traff Approximate organic traffic prognosis
status_msg Response "Ok" or "Error" report on a successful or unsuccessful request
status_code Response code "200" — successful request. Errors occur when limits are exceeded (number of simultaneous requests or account limits)
left_lines API limits remaining

Part of the API response, for which 1 limit is charged:

"visible_static": 0.0087,
"domain": "",
"ads": 191,
"visible": 0.0087,
"rised_keywords": 32,
"keywords": 430,
"down_keywords": 28,
"new_keywords": 101,
"ad_keywords": 293,
"traff": 2575,
"out_keywords": 37,
"date": "2016-11-13"

Example PHP Python
Request data:
Response data:
  "result": [
      "visible_static": 0.0087,
      "domain": "",
      "ads": 191,
      "visible": 0.0087,
      "rised_keywords": 32,
      "keywords": 430,
      "down_keywords": 28,
      "new_keywords": 101,
      "ad_keywords": 293,
      "traff": 2575,
      "out_keywords": 37,
      "date": "2016-11-13"
      "domain": "",
      "rised_keywords": 126,
      "visible": 0.5986,
      "traff": 21714,
      "keywords": 2131,
      "visible_static": 0.5986,
      "date": "2017-10-23",
      "ads": 108,
      "new_keywords": 90,
      "down_keywords": 100,
      "ad_keywords": 247,
      "out_keywords": 61
  "status_msg": "OK",
  "status_code": 200,
  "left_lines": 9878
// This example works on serpstat-sdk only

require_once __DIR__ . '/../vendor/autoload.php';
// configure your application
$config = [
    'token' => '19666fc1ae1724da1d5ea2f3a99d5f5a',
$domain = '';
// init client with your serpstat api token
$apiClient = new \Serpstat\Sdk\Core\ApiGuzzleHttpClient($config['token']);
// create instance of any api method class
// list of methods classes in folder src\Methods
$apiMethod = new \Serpstat\Sdk\Methods\DomainHistoryMethod(
try {
    // try call api method
    $response = $apiClient->call($apiMethod);
} catch (\Exception $e) {
    // catch api error
    $response = $e->getMessage();
import codecs
import json
import pprint
import urllib.request as urlrequest
from urllib.parse import urlencode

host = ''

method = 'domain_history'
params = {
    'query': '',  # string for get info
    'se': 'g_us',  # string search engine
    'token': 'ijmiom4f5m34905g03um8342dm04923lre3w',  # string personal token

api_url = "{host}/{method}?{params}".format(

    json_data = urlrequest.urlopen(api_url).read()
except Exception as e0:
    print("API request error: {error}".format(error=e0))

data = json.loads(json_data)

Share this article with your friends

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Back To Login

Don’t worry! Just fill in your email and we’ll send over your password.

Are you sure?


To complete your registration you need to enter your phone number


We sent confirmation code to your phone number

Your phone Resend code Queries left

Something went wrong.

Contact our support team
Or confirm the registration using the Telegram bot Follow this link
Please pick the project to work on

Personal demonstration

Serpstat is all about saving time, and we want to save yours! One of our specialists will contact you and discuss options going forward.

These may include a personal demonstration, a trial period, comprehensive training articles & webinar recordings, and custom advice from a Serpstat specialist. It is our goal to make you feel comfortable while using Serpstat.




We are glad of your comment
Upgrade your plan

Upgrade your plan

Export is not available for your account. Please upgrade to Lite or higher to get access to the tool. Learn more

Sign Up Free

Спасибо, мы с вами свяжемся в ближайшее время

View Editing


You have run out of limits

You have reached the limit for the number of created projects. You cannot create new projects unless you increase the limits or delete existing projects.

I want more limits