Отримання списку сторінок та їх позицій для домену (getUrlsSerpResultsHistory)
Метод getUrlsSerpResultsHistory повертає сторінки та їх позиції у регіоні для домену.
| Параметри запиту | ||
| Параметр | Значення | Опис |
| id | any number or string | Ідентифікатор запиту |
| method | RtApiSerpResultsProcedure.getUrlsSerpResultsHistory | Назва методу API |
| params | {...} | Об'єкт з параметрами |
| projectId | number | Ідентифiкатор проекту |
| projectRegionId | number | Ідентифікатор регіону |
| page | number | Номер сторінки. За замовчуванням: 1 |
| pageSize (необов'язково) | number (20,50,100,200,500) | Кількість результатів на сторінку. За замовчуванням: 100 |
| dateFrom (необов'язково) | date (yyyy-mm-dd) | Дата початку періоду, за який потрібні дані |
| dateTo (необов'язково) | date (yyyy-mm-dd) | Дата кiнця періоду, за який потрібні дані |
| sort (необов'язково) | string (date — за датою, keyword — за алфавітом) |
Сортування за параметрами |
| order (необов'язково) | string (desc — за зменшенням, asc — за зростанням) |
Напрям сортування. За замовчуванням: за зменшенням. |
| keywords (необов'язково) | array:[“string”] | Ключові фрази, за якими потрібні сторінки та позиції. Максимальна кількість фраз, які можна відфільтрувати — 1000. |
| domain (необов'язково) | string (domain.com — домен, https://domain.com/ — сторінка) |
Домен або сторінка, за якими потрібні дані. За замовчуванням: домен проекту. |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор запиту |
| result | Інкапсулює в собі відповідь |
| projectId | Ідентифікатор проекту |
| projectRegionId | Ідентифікатор регіону |
| domain | Домен або сторінка, за якими робили запит |
| keywords | Масив ключових фраз |
| keyword | Ключова фраза з даними |
| history | Масив дат з видачею по ключовій фразі |
| date | Дата видачі |
| positions | Масив позицій з доменом або сторінкою |
| position | Позиція |
| url | Сторінка |
| positionBlock (тiльки для PPC) | Блок контекстної реклами |
| summary info | Блок зведеної інформації |
| page | Поточна сторінка |
| page_total | Кількість сторінок з результатами при обраному параметрі page size |
| count | Кількість результатів на сторінку |
| total | Загальна кількість результатів |
| sort | Сортування за параметрами |
| order | Напрям сортування |
Request data:
{
"id": 1,
"method": "RtApiSerpResultsProcedure.getUrlsSerpResultsHistory",
"params": {
"projectId": 704912,
"projectRegionId": 259628,
"page": 1,
"pageSize": 500,
"dateFrom": "2020-05-07",
"dateTo": "2020-05-08",
"sort": "date",
"order": "desc",
"keywords": ["авито снять квартиру без посредников","авито воронеж недвижимость снять квартиру посуточно"],
"domain": "www.avito.ru"
}
}Response data:
{
"id": "1",
"result": {
"data": {
"projectId": 704912,
"projectRegionId": 259628,
"domain": "www.avito.ru",
"keywords": [
{
"keyword": "авито снять квартиру без посредников",
"history": [
{
"date": "2020-05-08",
"positions": [
{
"position": 1,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/na_dlitelnyy_srok?utm_medium=cpc&avito_campaign_id=51071367&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_brand_perf&utm_term=снять квартиру авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_b&adjust_adgroup=51071367&adjust_creative=8905066830_снять квартиру авито&utm_content=k50id|0100000020327631876_|cid|51071367|gid|4164591213|aid|8905066830|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327631876_&yclid=2466777477462653662",
"positionBlock": "top"
},
{
"position": 2,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/na_dlitelnyy_srok?utm_medium=cpc&avito_campaign_id=51071367&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_brand_perf&utm_term=снять квартиру авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_b&adjust_adgroup=51071367&adjust_creative=8905066830_снять квартиру авито&utm_content=k50id|0100000020327631876_|cid|51071367|gid|4164591213|aid|8905066830|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327631876_&yclid=2466777570443558736",
"positionBlock": "sidebar"
}
]
},
{
"date": "2020-05-07",
"positions": [
{
"position": 1,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/na_dlitelnyy_srok?utm_medium=cpc&avito_campaign_id=51071367&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_brand_perf&utm_term=снять квартиру авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_b&adjust_adgroup=51071367&adjust_creative=8905066830_снять квартиру авито&utm_content=k50id|0100000020327631876_|cid|51071367|gid|4164591213|aid|8905066830|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327631876_&yclid=2444010384444654818",
"positionBlock": "top"
},
{
"position": 2,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/na_dlitelnyy_srok?utm_medium=cpc&avito_campaign_id=51071367&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_brand_perf&utm_term=снять квартиру авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_longrent_search_23032020_MSC_b&adjust_adgroup=51071367&adjust_creative=8905066830_снять квартиру авито&utm_content=k50id|0100000020327631876_|cid|51071367|gid|4164591213|aid|8905066830|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327631876_&yclid=2444010450860409732",
"positionBlock": "sidebar"
}
]
}
]
},
{
"keyword": "авито воронеж недвижимость снять квартиру посуточно",
"history": [
{
"date": "2020-05-08",
"positions": [
{
"position": 1,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/posutochno?utm_medium=cpc&avito_campaign_id=51071362&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_brand_perf&utm_term=снять посуточно авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_&adjust_adgroup=51071362&adjust_creative=8905065857_снять посуточно авито&utm_content=k50id|0100000020327630438_|cid|51071362|gid|4164590988|aid|8905065857|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327630438_&yclid=2466654480830848230",
"positionBlock": "top"
},
{
"position": 2,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/posutochno?utm_medium=cpc&avito_campaign_id=51071362&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_brand_perf&utm_term=снять посуточно авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_&adjust_adgroup=51071362&adjust_creative=8905065857_снять посуточно авито&utm_content=k50id|0100000020327630438_|cid|51071362|gid|4164590988|aid|8905065857|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327630438_&yclid=2466654558151802634",
"positionBlock": "sidebar"
}
]
},
{
"date": "2020-05-07",
"positions": [
{
"position": 1,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/posutochno?utm_medium=cpc&avito_campaign_id=51071362&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_brand_perf&utm_term=снять посуточно авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_&adjust_adgroup=51071362&adjust_creative=8905065857_снять посуточно авито&utm_content=k50id|0100000020327630438_|cid|51071362|gid|4164590988|aid|8905065857|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327630438_&yclid=2443885118370644870",
"positionBlock": "top"
},
{
"position": 2,
"url": "https://www.avito.ru/moskva_i_mo/kvartiry/sdam/posutochno?utm_medium=cpc&avito_campaign_id=51071362&utm_source=yandex&utm_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_brand_perf&utm_term=снять посуточно авито&idfa=ios_ifa&gps_adid=google_aid&adjust_t=bkgc5n_oxuwg2&adjust_campaign=web_yandex_buyers_c2c_realty_shortrent_search_23032020_MSC_&adjust_adgroup=51071362&adjust_creative=8905065857_снять посуточно авито&utm_content=k50id|0100000020327630438_|cid|51071362|gid|4164590988|aid|8905065857|adp|no|pos|premium1|src|search_none|dvc|desktop|main&k50id=0100000020327630438_&yclid=2443885410107814412",
"positionBlock": "sidebar"
}
]
}
]
}
]
},
"summary_info": {
"page": 1,
"page_total": 1,
"count": 500,
"total": 2,
"sort": "date",
"order": "desc"
},
"spent_limits": 0
}
}