Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

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

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
Повернутися до авторизації

Не хвилюйтеся! Лише заповніть поле з вашою email адресою і ми вишлемо вам листа для відновлення паролю.

Ви впевнені?

Awesome!

To complete your registration you need to enter your phone number

Назад

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

Your phone Resend code Залишилося запитів

Щось пішло не так.

Зв'яжіться з нашою службою підтримки
Або підтвердіть регістарціі за допомогою Телеграм бота Перейдіть за цим посиланням
Виберіть проєкт, по якому хочете отримувати дані

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

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

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Покращити план

Експорт недоступний для вашого тарифного плану. Вам необхідно поліпшити свій тариф до Lite або вище, щоб отримати доступ до інструменту. Детальніше

Sign Up Free

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Запрошення
Просмотр Редактирование

E-mail
Повідомлення
Необов'язково
E-mail
Повідомлення
Необов'язково

У вас закінчилися ліміти

Ви досягли ліміту на кількість створених проєктів і більше не можете створювати нові проєкти. Збільште ліміти або видаліть існуючі проєкти.

Я хочу більше лімітів
Відкрити чат технічної підтримки