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

Example PHP Python

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
    }
}