Отримання історії пошукової видачі у регіоні за ключовими фразами проекту

Метод getKeywordsSerpResultsHistory повертає топ-100 результатiв пошукової видачi Google у вибраному регіоні за ключовими фразами проєкту. Метод доступний тільки для органічної видачі.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр	Опис	Тип	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор	int/string	ні		Будь-яке числове або текстове значення. Наприклад: 1, test, хаймарс
method	Назва методу API	string	ні		RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		ні
projectId	Ідентифікатор проєкту	number	ні		Числове значення ідентифікатору проєкту
projectRegionId	Ідентифiкатор регіону	number	ні		Числове значення ідентифікатору регіону
page	Номер сторінки	number	ні	1	Числове значення
pageSize	Кількість результатів на сторінку	number	так	100	Числове значення. Можливі значення: 20, 50, 100, 200, 500
dateFrom	Дата початку періоду, за який потрібні дані	date	так		Числове значення, формат даних: yyyy-mm-dd
dateTo	Дата кінця періоду, за яким потрібні дані	date	так		Числове значення, формат даних: yyyy-mm-dd
sort	Сортування за параметрами	string	так	alphabetically	"date" — Сортування за датою, "keyword" — Сортування за алфавітом
order	Напрям сортування	string	так	desc	desc — за спаданням, asc — за зростанням
keywords	Ключові фрази, для яких потрібні сторінки та позиції	array	так		Текстове значення. Максимальна кількість фраз, які можна фільтрувати — 1000.

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Об'єкт з даними
projectId	Ідентифікатор проєкту
projectRegionId	Ідентифікатор регіону
keywords	Масив ключових фраз
keyword	Ключова фраза з даними
frequency	Частотність ключової фрази за місяць в обраній країні чи місті
expectedUrl	Цільова сторінка, яка оптимізується під конкретну фразу (якщо вона була додана у проєкті)
history	Масив дат з видачею по ключовій фразі
date	Дата видачі
positions	Масив позицій з доменом або сторінкою
position	Позиція
url	Сторінка, яка показується у результатах пошуку за певною фразою
summary info	Блок зведеної інформації
page	Поточна сторінка
page_total	Кількість сторінок з результатами при обраному параметрі pageSize
count	Кількість результатів на сторінку
total	Загальна кількість результатів
sort	Сортування за параметрами
order	Напрям сортування

За цим методом ліміти API не списуються.

Example

Request data:

{
    "id": 1,
    "method": "RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory",
    "params": {
        "projectId": 853932,
        "projectRegionId": 293402,
        "page": 1,
        "pageSize": 100,
        "dateFrom": "2021-12-11",
        "dateTo": "2021-12-12",
        "sort": "date",
        "order": "asc",
        "keywords": ["adidas track"]
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": {
            "projectId": 853932,
            "projectRegionId": 293402,
            "keywords": [
                {
                    "keyword": "adidas track",
                    "frequency": 49500,
                    "expectedUrl": "https://www.adidas.com/us/track",
                    "history": [
                        {
                            "date": "2021-12-11",
                            "positions": [
                                {
                                    "position": 1,
                                    "url": "https://www.adidas.com/us/track"
                                },
                                {
                                    "position": 2,
                                    "url": "https://www.adidas.com/us/track_suits"
                                },
                                {
                                    "position": 3,
                                    "url": "https://www.adidas.com/us/track_field"
                                },


...


                                {
                                    "position": 95,
                                    "url": "https://www.ispot.tv/ad/oI7z/adidas-worn-without-care-featuring-jay-rock"
                                }
                            ]
                        },
                        {
                            "date": "2021-12-12",
                            "positions": [
                                {
                                    "position": 1,
                                    "url": "https://www.adidas.com/us/track"
                                },
                                {
                                    "position": 2,
                                    "url": "https://www.adidas.com/us/track_suits"
                                },
                                {
                                    "position": 3,
                                    "url": "https://www.adidas.com/us/track_field"
                                },

...

                                {
                                    "position": 96,
                                    "url": "https://www.journeys.com/track-order"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        "summary_info": {
            "page": 1,
            "page_total": 1,
            "count": 100,
            "total": 1,
            "sort": "date",
            "order": "asc"
        },
        "spent_limits": 0
    }
}