Отримання списку топ-20 доменів за фразами проекту (getTopCompetitorsDomainsHistory)
Метод getTopCompetitorsDomainsHistory повертає список доменів, що потрапили у топ-20 пошукової видачi у регіонi мінімум за двома фразами проекту.
| Параметри запиту | ||
| Параметр | Значення | Опис |
| id | any number or string | Ідентифікатор запиту |
| method | RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory | Назва методу API |
| params | {...} | Масив з параметрами |
| projectId | number |
Ідентифiкатор проекту
|
| projectRegionId | number |
Ідентифікатор регіону
|
| page | number |
Номер сторінки. За замовчуванням: 1
|
| pageSize (необов'язково) | number (20,50,100,200,500) | Кількість результатів на сторінці. За замовчуванням: 100 |
| dateFrom (необов'язково) | date (yyyy-mm-dd) |
Дата початку періоду, за який необхідно отримати дані. За замовчуванням: 30 днів від останнього зняття позицій.
|
| dateTo (необов'язково) | date (yyyy-mm-dd) |
Дата кінця періоду, за який необхідно отримати данi. За замовчуванням: дата останнього зняття позицій.
|
| sort (необов'язково) | string (sum_traffic — розподіл трафіку, keywords_count — кількість ключових фраз, avg_position — середня позиція, position_ranges — діапазони розподілу позицій, ads_count — кількість платних обяв) |
Параметр, за яким буде проходити сортування. За замовчуванням: за розподілом трафіку. |
| sortRange (необов'язково) | string
(top1\top2... — розподіл по позиціях keywords_count_bottom\keywords_count_top\ — розподіл по рекламних блоках avg_position_top\avg_position_bottom\ — середня позиція у рекламному блоці) |
Використовується при сортуванні за параметром position_ranges.
|
| order (необов'язково) | string (desc | asc) | Напрям сортування. За замовчуванням: за зменшенням. |
| domains (необов'язково) | array:[“string”] | Домен, для якого потрібно отримати дані. За замовчуванням: всі домени, що потрапили у топ-20 хоча б по 2 фразах проекту. |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор запиту |
| result | Інкапсулює в собі відповідь |
| projectId | Ідентифікатор проекту |
| projectRegionId | Ідентифікатор регіону |
| competitors | Масив з доменами |
| domain | Домен, що потрапив у топ-20 хоча б за двома фразами проекту |
| dates | Масив дат з даними за вказаним доменом |
| date | Дата, за якою виводяться дані по домену |
| value | Значення параметру |
| traffic_distribution | Розподіл трафіку домену серед усіх доменів топ-20 пошукової видачі |
| avg_position | Середня позиція домена серед кращих позицій по ключових фразах проєкту |
| keywords_count | Кількість ключових фраз, по яких домен потрапив у видачу |
| keywords_by_ranges | Розподіл ключових фраз за діапазонами позицій домена |
| top1 | Ключові фрази, за якими домен зайняв 1 позицию |
| top3 | Ключові фрази, за якими домен зайняв 2-3 позиції |
| top5 | Ключові фрази, за якими домен зайняв 4-5 позиції |
| top10 | Ключові фрази, за якими домен зайняв 6-10 позиції |
| top20 | Ключові фрази, за якими домен зайняв 11-20 позиції |
| top101 | Ключові фрази, за якими домен зайняв 21-100 позиції в Google, та 21-50 в Yandex |
| Регіони з контекстом | |
| ads_count | Кількість оголошень з доменом які були виявленi в контексті |
| keywords_count_blocks | Розподіл ключових фраз у блоках контексту |
| avg_position_blocks | Середня позиція у блоках контексту |
| top | Верхній блок реклами |
| sidebar | Бічний блок реклами |
| bottom | Нижній блок реклами |
| summary info | Блок зведеної інформації |
| page | Поточна сторінка |
| page_total | Кількість сторінок з результатами при обраному параметрі page size |
| count | Кількість результатів на сторінку |
| total | Загальна кількість результатів |
| sort | Сортування за параметрами |
| order | Напрям сортування |
Request data:
{
"id": "1",
"method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
"params": {
"projectId": 651696,
"projectRegionId": 249084,
"page": 1,
"pageSize": 20,
"dateFrom": "2020-08-27",
"dateTo": "2020-08-28",
"sort": "domain",
"order": "asc",
"domains": [
"fursk.ru",
"ozon.ru"
]
}
}
Response data:
{
"id": "1",
"result": {
"data": {
"projectId": 651696,
"projectRegionId": 249084,
"competitors": [
{
"domain": "fursk.ru",
"dates": {
"1": {
"date": "2020-08-28",
"result": {
"traffic_distribution": {
"value": 2.52
},
"avg_position": {
"value": 31.5
},
"keywords_count": {
"value": 6015
},
"keywords_by_ranges": {
"top1": {
"value": 50
},
"top3": {
"value": 206
},
"top5": {
"value": 258
},
"top10": {
"value": 752
},
"top20": {
"value": 1400
},
"top101": {
"value": 3349
}
}
}
}
}
},
{
"domain": "ozon.ru",
"dates": {
"1": {
"date": "2020-08-28",
"result": {
"traffic_distribution": {
"value": 2.0299999999999998
},
"avg_position": {
"value": 31.600000000000001
},
"keywords_count": {
"value": 4333
},
"keywords_by_ranges": {
"top1": {
"value": 66
},
"top3": {
"value": 151
},
"top5": {
"value": 146
},
"top10": {
"value": 414
},
"top20": {
"value": 1168
},
"top101": {
"value": 2388
}
}
}
}
}
}
]
},
"summary_info": {
"page": 1,
"page_total": 1,
"count": 20,
"total": 2,
"sort": "domain",
"order": "asc"
},
"spent_limits": 0
}
}