История по домену V4 (SerpstatDomainProcedure.getDomainsHistory)
SerpstatDomainProcedure.getDomainsHistory — метод возвращает историю изменения видимости и количества фраз по домену.
Параметры запроса:
Метрика |
Описание |
Опциональный |
Значение по умолчанию |
Варианты значений |
domain |
Имя домена |
нет |
- |
|
se |
Идентификатор поисковой базы, по которой будет проходить поиск |
нет |
- |
g_ua |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
- |
{"ads":"desc"} |
page |
Номер страницы в ответе |
да |
1 |
5 |
size |
Количество результатов на страницу в ответе |
да |
100 |
100-1000 |
Сортировка результатов возможна по следующим полям:
Параметр |
date
|
down_keywords
|
visible
|
rised_keywords
|
keywords
|
traff |
visible_static |
new_keywords |
out_keywords |
down_keywords |
ad_keywords |
Метрики ответа:
Метрики |
Описание |
result |
Инкапсулирует в себе ответ |
visible |
Видимость сайта |
domain |
Домен |
keywords |
Количество найденных ключевых фраз в выбранной поисковой системе |
traff |
Индекс, который показывает ориентировочный органический трафик на сайт (количество посетителей) |
date |
Дата текущей проверки видимости, ключевых фраз и трафика |
new_keywords |
Количество новых ключевых фраз, которые появились у домена за последние 2 недели |
out_keywords |
Количество ключевых фраз, которые потерял домен за последние 2 недели |
rised_keywords |
Ключевые фразы, по которым выросли позиции за последние 2 недели |
down_keywords |
Ключевые фразы, по которым упали позиции за последние 2 недели |
ad_keywords |
Количество ключевых фраз в PPC |
ads |
Количество объявлений в PPC |
left_lines |
Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "google.com",
"rised_keywords": 176915,
"visible": 5995.61211,
"traff": 120802965,
"keywords": 3964146,
"visible_static": 5995.61211,
"date": "2018-07-05",
"ads": 1662,
"new_keywords": 184914,
"down_keywords": 232468,
"ad_keywords": 7638,
"out_keywords": 146804
}
{
"id": {{any_num_or_string}},
"method": "SerpstatDomainProcedure.getDomainsHistory",
"params": {
"domain": {{domain}},
"se": {{search_engine}},
(optional) "sort": { {{field}}: {{"asc"|"desc"}}},
(optional) "page": {{page}},
(optional) "size": {{page_size}}
}
}
{
"id": {{your_num_or_string}},
"result": {
"data": [
{
"domain": "google.com",
"rised_keywords": 176915,
"visible": 5995.61211,
"traff": 120802965,
"keywords": 3964146,
"visible_static": 5995.61211,
"date": "2018-07-05",
"ads": 1662,
"new_keywords": 184914,
"down_keywords": 232468,
"ad_keywords": 7638,
"out_keywords": 146804
},
],
"summary_info": {
"page": 1,
"left_lines": 99268,
"total": 3809
}
}
}