Получение списка доменов из топ-20 по ключевым фразам проекта (getTopCompetitorsDomainsHistory)
Метод getTopCompetitorsDomainsHistory возвращает список доменов по региону проекта, которые попали в топ-20 минимум по 2 любым ключевым фразам проекта.
| Параметры запроса | ||
| Параметр | Значение | Описание |
| id | any number or string | Идентификатор запроса |
| method | RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory | Название метода API |
| params | {...} | Массив с параметрами |
| projectId | number |
Идентификатор проекта
|
| projectRegionId | number |
Идентификатор региона
|
| page | number |
Номер страницы. По умолчанию: 1
|
| pageSize (необязательно) | number (20,50,100,200,500) | Количество результатов на странице. По умолчанию: 100 |
| dateFrom (необязательно) | date (yyyy-mm-dd) |
Дата начала периода, по которому нужны данные. По умолчанию -30 дней от последнего снятия позиции.
|
| dateTo (необязательно) | date (yyyy-mm-dd) |
Дата конца периода, по которому нужны данные. По умолчанию дата последнего снятия позиции.
|
| 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, минимум по 2 ключевым фразам проекта |
| 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 | Количество объявлений с доменом, которые встретились в контексте |
| 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
}
}Request data for PPC
{
"id": "1",
"method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
"params": {
"projectId": 650028,
"projectRegionId": 249037,
"page": 1,
"pageSize": 20,
"dateFrom": "2020-10-22",
"dateTo": "2020-10-23",
"sort": "domain",
"order": "asc",
"domains":["citrus.ua","comfy.ua","allo.ua"]
}
}{
"id": "1",
"result": {
"data": {
"projectId": 650028,
"projectRegionId": 249037,
"competitors": [
{
"domain": "allo.ua",
"dates": {
"1": {
"date": "2020-10-22",
"result": {
"keywords_count": {
"value": 3
},
"ads_count": {
"value": 3
},
"keywords_count_blocks": {
"top": {
"value": 1
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 2
}
},
"avg_position_blocks": {
"top": {
"value": 1
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 1.5
}
}
}
},
"2": {
"date": "2020-10-23",
"result": {
"keywords_count": {
"value": 6
},
"ads_count": {
"value": 6
},
"keywords_count_blocks": {
"top": {
"value": 2
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 4
}
},
"avg_position_blocks": {
"top": {
"value": 1.5
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 1.3
}
}
}
}
}
},
{
"domain": "citrus.ua",
"dates": {
"1": {
"date": "2020-10-22",
"result": {
"keywords_count": {
"value": 49
},
"ads_count": {
"value": 49
},
"keywords_count_blocks": {
"top": {
"value": 35
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 14
}
},
"avg_position_blocks": {
"top": {
"value": 1.1000000000000001
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 1.2
}
}
}
},
"2": {
"date": "2020-10-23",
"result": {
"keywords_count": {
"value": 60
},
"ads_count": {
"value": 60
},
"keywords_count_blocks": {
"top": {
"value": 44
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 16
}
},
"avg_position_blocks": {
"top": {
"value": 1.1000000000000001
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 1.3999999999999999
}
}
}
}
}
},
{
"domain": "comfy.ua",
"dates": {
"1": {
"date": "2020-10-22",
"result": {
"keywords_count": {
"value": 13
},
"ads_count": {
"value": 13
},
"keywords_count_blocks": {
"top": {
"value": 7
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 6
}
},
"avg_position_blocks": {
"top": {
"value": 1
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 1
}
}
}
},
"2": {
"date": "2020-10-23",
"result": {
"keywords_count": {
"value": 28
},
"ads_count": {
"value": 28
},
"keywords_count_blocks": {
"top": {
"value": 15
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 13
}
},
"avg_position_blocks": {
"top": {
"value": 1
},
"sidebar": {
"value": 0
},
"bottom": {
"value": 1.2
}
}
}
}
}
}
]
},
"summary_info": {
"page": 1,
"page_total": 1,
"count": 20,
"total": 3,
"sort": "domain",
"order": "asc"
},
"spent_limits": 0
}
}