Отримання історії пошукової видачі у регіоні за ключовими фразами проекту
Метод getKeywordsSerpResultsHistory повертає топ-100 результатiв пошукової видачi Google та топ-50 Yandex у вибраному регіоні за ключовими фразами проєкту. Метод доступний тільки для органічної видачі.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Параметри запиту | |||
Параметр | Значення | Опис | |
id | обов'язково | any number or string | Ідентифікатор запиту |
method | обов'язково | RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory | Назва методу API |
params | обов'язково | {...} | Об'єкт з параметрами |
projectId | обов'язково | number | Ідентифікатор проєкту |
projectRegionId | обов'язково | number | Ідентифiкатор регіону |
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 | Ключові фрази, для яких потрібні сторінки та позиції. Максимальна кількість фраз, які можна відфільтрувати, — 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 не списуються.
{
"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"]
}
}
{
"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
}
}