Получение списка страниц и их позиций по домену (getUrlsSerpResultsHistory)
Метод getUrlsSerpResultsHistory возвращает ссылки и их позиции по региону для домена.
| Параметры запроса | ||
| Параметр | Значение | Описание |
| id | any number or string | Идентификатор запроса |
| method | RtApiSerpResultsProcedure.getUrlsSerpResultsHistory | Название метода API |
| params | {...} | Объект с параметрами |
| projectId | number | Идентификатор проекта |
| projectRegionId | number | Идентификатор региона |
| page | number | Номер страницы. По умолчанию 1 |
| pageSize (необязательно) | number (20,50,100,200,500) | Количество результатов на страницу. По умолчанию 100 |
| dateFrom (необязательно) | date (yyyy-mm-dd) | Дата начала периода, по которому нужны данные |
| dateTo (необязательно) | date (yyyy-mm-dd) | Дата окончания периода, по которому нужны данные |
| 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 (только для 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
}
}