Некоторые функции ограничены. Зарегистрируйтесь бесплатно

Получение истории выдачи в регионе по ключевым фразам (getKeywordsSerpResultsHistory)

Метод getKeywordsSerpResultsHistory возвращает топ-100 выдачи в Google и топ-50 в Yandex по региону и ключевым фразам проекта. Метод доступен только для органической выдачи.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса
Параметр Значение Описание
id обязательно any number or string Идентификатор запроса
method обязательно RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory Название метода 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 Ключевые фразы, по которым нужны страницы и позиции. Максимальное количество фраз, которые можно отфильтровать, —  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 Направление сортировки

По этому методу лимиты не списываются.

Example
Request data:
{
    "id": 1,
    "method": "RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory",
    "params": {
        "projectId": 853932,
        "projectRegionId": 293402,
        "page": 1,
        "pageSize": 500,
        "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": 500,
            "total": 1,
            "sort": "date",
            "order": "asc"
        },
        "spent_limits": 0
    }
}

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

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

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

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

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

Открыть чат технической поддержки