История по домену (domain_history)
domain_history — метод возвращает историю изменения видимости и количества фраз по домену.
| Metrics | Description |
| result | Инкапсулирует в себе ответ |
| visible_static | Видимость |
| visible | Видимость сайта |
| domain | Домен |
| keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
| ads | Количество объявлений {date} |
| ad_keywords | Количество ключевых фраз в PPC |
| new_keywords | Количество новых ключевых фраз которые появились у домена за последние N дней |
| out_keywords | Количество ключевых фраз которые потерял домен за последние N дней |
| rised_keywords | Ключевые фразы у которых выросли позиции за последние N-дней |
| down_keywords | Ключевые фразы у которых упали позиции за последние N-дней |
| date | Дата проверки определенного элемента массива |
| traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
| status_msg | Ответ: "OK" или "Error", сообщает об удачном или неудачном запросе |
| status_code | Код ответа "200" — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта) |
| left_lines | Количество оставшихся API строк |
Часть ответа API, за которую снимается 1 лимит:
{
"visible_static": 0.0087,
"domain": "serpstat.com",
"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"
},
"visible_static": 0.0087,
"domain": "serpstat.com",
"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"
},
Request data:
Response data:
{
"result":[
{
"visible_static":0.0087,
"domain":"serpstat.com",
"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":"serpstat.com",
"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
}<?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\DomainHistoryMethod(
$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();
}import codecs
import json
import pprint
import urllib.request as urlrequest
from urllib.parse import urlencode
host = 'http://api.serpstat.com/v3'
method = 'domain_history'
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)