Некоторые функции ограничены.

Serpstat использует файлы cookie для обеспечения работоспособности сервиса, улучшения навигации, предоставления возможности связаться с командой поддержки, а также маркетинговых активностей Serpstat.

Нажав кнопку "Принять и продолжить", вы соглашаетесь с Политикой конфиденциальности

Вход Регистрация

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

Поделитесь статьей с вашими друзьями

Войти Регистрация

Вы исчерпали лимит запросов.

Или email
Забыли пароль?
Или email
Optional
Back To Login

Не волнуйтесь! Напишите свой электронный адрес и мы пришлем вам новый пароль.

Вы уверены?

Awesome!

To complete your registration you need to enter your phone number

Назад

Мы отправили код подтверждения на ваш номер телефона

Your phone Resend code Осталось запросов

Что-то пошло не так.

Свяжитесь с нашей службой поддержки
Или подтвердите регистрацию с помощью Телеграм бота Перейдите по этой ссылке
Выберите один из проектов

Знакомство с сервисом

Ознакомьтесь с основными возможностями Serpstat удобным способом!

Отправьте заявку для ознакомления с сервисом и мы свяжемся с вами в кратчайшие сроки. Наш специалист предложит подходящий вариант, который может включать персональную демонстрацию, пробный период, материалы для обучения и повышения экспертизы, личную консультацию, а также комфортные условия для начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Увеличить лимиты

Улучшить тариф

Экспорт недоступен для вашего тарифного плана. Вам необходимо улучшить свой тариф до Lite или выше, чтобы получить доступ к инструменту Подробнее

Зарегистрироваться

Спасибо, мы с вами свяжемся в ближайшее время

Пригласить
Просмотр Редактирование

E-mail
Сообщение
необязательно
E-mail
Сообщение
необязательно

У вас закончились лимиты

Вы достигли лимита на количество созданных проектов и больше не можете создавать новые проекты. Увеличьте лимиты или удалите существующие проекты.

Я хочу больше лимитов