Получение списка страниц и их позиций по домену (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 | Направление сортировки |
{
"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"
}
}
{
"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
}
}