Domain Summary (domain_info)
domain_info
This report provides you with the number of keywords domain uses in SEO and PPC, shows its online visibility and other metrics.
| Metrics | Description |
| result | Encapsulates the answer |
| visible | Site visibility |
| keywords | The number of keywords found in the chosen search engine |
| traff |
Estimate traffic based on keyword positions and search volume
|
| visible_dynamic | Change in visibility since the last upgrade |
| keywords_dynamic | Change in the number of keywords over the last N-time |
| traff_dynamic | Traffic change over the last n-time (in comparison with ""prev_date"") |
| date | Current visibility, keywords, and traffic verification date |
| prev_date | Previous verification date |
| new_keywords | The number of acquired keywords for the domain over the last N-days |
| out_keywords | Number of keywords lost by a domain over 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 |
| ad_keywords | Number of keywords in PPC |
| ads | Number of the PPC ads |
| ads_dynamic | History of changes in PPC Ads |
| 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 |
Request data:
<?php
// This example works on serpstat-sdk only
// https://github.com/SerpstatGlobal/serpstat-sdk
require_once __DIR__ . '/../vendor/autoload.php';
// configure your application
$config = [
'token' => '19666fc1ae1724da1d5ea2f3a99d5f5a',
];
$domain = 'example.com';
// 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\DomainInfoMethod(
$domain,
\Serpstat\Sdk\Interfaces\IApiClient::SE_GOOGLE_RU
);
try {
// try call api method
$response = $apiClient->call($apiMethod);
} catch (\Exception $e) {
// catch api error
$response = $e->getMessage();
}Response data:
{
"result":{
"domain":"example.com",
"visible":1156.33656,
"keywords":705906,
"traff":9686645,
"visible_dynamic":-4.1032299999999,
"keywords_dynamic":-115,
"traff_dynamic":-25140,
"ads_dynamic":0,
"date":"2017-04-11",
"new_keywords":17,
"out_keywords":19,
"rised_keywords":39,
"down_keywords":84,
"ad_keywords":3103,
"ads":1882,
"prev_date":"2017-04-10"
},
"status_msg":"OK",
"status_code":200,
"left_lines":999567
}Request data:
import codecs
import json
import pprint
import urllib.request as urlrequest
from urllib.parse import urlencode
host = 'http://api.serpstat.com/v3'
method = 'domain_info'
params = {
'query': 'example.com', # string for get info
'se': 'g_us', # string search engine
'token': 'ijmiom4f5m34905g03um8342dm04923lre3w', # string personal token
}
api_url = "{host}/{method}?{params}".format(
host=host,
method=method,
params=urlencode(params)
)
try:
json_data = urlrequest.urlopen(api_url).read()
except Exception as e0:
print("API request error: {error}".format(error=e0))
data = json.loads(json_data)
pprint.pprint(data)
Response data:
{
"result":{
"domain":"example.com",
"visible":1156.33656,
"keywords":705906,
"traff":9686645,
"visible_dynamic":-4.1032299999999,
"keywords_dynamic":-115,
"traff_dynamic":-25140,
"ads_dynamic":0,
"date":"2017-04-11",
"new_keywords":17,
"out_keywords":19,
"rised_keywords":39,
"down_keywords":84,
"ad_keywords":3103,
"ads":1882,
"prev_date":"2017-04-10"
},
"status_msg":"OK",
"status_code":200,
"left_lines":999567
}