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

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

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

Сообщить об ошибке

Отменить
826 5 2
Новости Читать 12 минут 2 октября 2020

Как отслеживать позиции сайта через API: новые методы в API Serpstat для Мониторинга позиций

Как отслеживать позиции сайта через API: новые методы в API Serpstat для Мониторинга позиций
Максим Астахов
Максим Астахов
Product/Project manager at Serpstat
API Мониторинга позиций — новый и важный шаг в развитии нашего сервиса. Публичные методы API дают пользователям свободу действий и понятный флоу в работе с данными. Кроме того, API Мониторинга не будет тратить ваши лимиты, а полнота данных будет соответствовать интерфейсу, а в некоторых случаях даст возможность получить даже больше информации.

Например, сейчас в отчете «Ключевые фразы» мы показываем только лучшую позицию домена, а при помощи метода API можно будет увидеть все позиции домена по выбранной ключевой фразе.
Сегодня я расскажу о том, что такое API Мониторинга позиций, как оно работает, не затрачивая лимиты, и какие данные отдает. Начнем :)

Что такое API Мониторинга позиций
API (программный интерфейс приложения, интерфейс прикладного программирования) — это способ получения данных, который помогает быстро получать большие объемы информации без использования интерфейса Serpstat. Также он позволяет интегрировать аналитику сервиса в свои внутренние инструменты.

API Serpstat касается модулей «Анализ сайта», «Анализ ключевых фраз», «Анализа ссылок», «Аудит сайта», «Мониторинг позиций». Среди наших клиентов API используют крупные и малые бизнесы, агентства и независимые SEO-специалисты. В их числе Flatfy (от ЛУН), Netpeak, Inweb, SeoMarket, Ingate, WebX.page, Masgroup.

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

Преимущества API Мониторинга позиций
API Мониторинга работает иначе, чем API других модулей. Он работает с готовыми данными пользователя, и за использование методов дополнительные лимиты сниматься не будут. Вы получаете такие преимущества:
1
Использование API без траты лимитов Мониторинга.
2
Выгрузка данных по всем проектам, без использования интерфейса Serpstat. Каждый из методов дает возможность получить данные по соответствущим отчетам: Ключевые фразы, Страницы, Конкуренты, История выдачи.
3
Быстрая работа с большим количеством данных на особо крупных проектах.
4
Возможность настроить ряд собственных запросов с разными наборами параметров: регионы и даты, как удобно.
5
Использование данных для построения собственного дашборда.
Хотите узнать, как использовать API Serpstat для отслеживания позиций?

Заказывайте бесплатную персональную демонстрацию сервиса, и наши специалисты вам все расскажут! ;)

Какие методы доступны
На данный момент доступна первая версия API Мониторинга. Она включает методы, которые будут отдавать только самые важные данные по проекту. Но мы продолжаем работу, поэтому предполагается еще две версии, которые будут разрабатываться одна за другой.

В первой версии доступно 4 метода, но они позволят полноценно получить данные из всех отчетов вашего проекта в Мониторинге позиций.

Метод #1: Получение списка регионов проекта и их статуса (getProjectRegions)
Этот метод предназначен для получения всех регионов проекта и их статусов. Вернутся как активные, так и деактивированные регионы. Пользователю в запросе необходимо только указать идентификатор проекта. В ответе будет список из идентификатора региона и настроек региона.

Пример запроса:
{
    "id": 1,
    "method": "RtApiSearchEngineProcedure.getProjectRegions",
    "params": {
        "projectId": 1
    }
}

Метод #2: Получение списка доменов из топ-20 по ключевым фразам проекта (getTopCompetitorsDomainsHistory)
Процедура заменяет отчет Конкуренты и позволит получить список доменов, которые попали в топ-20 выдачи хотя бы по 2 ключевым фразам проекта в 1 регионе.
В запросе необходимо указывать 1 идентификатор региона в проекте, по которому нужны данные.
Если в проекте несколько регионов, то можно параллельно сделать несколько запросов отдельно по регионам.
Можно не указывать период по датам, тогда метод вернет данные максимум по последним 30 дням.
Если вы захотите указывать период, он должен быть не больше 30 дней. В том случае, если нужно получить данные за больший период — сделайте несколько запросов с разными временными промежутками.
Можно сократить ответ, передав в запросе только те домены, по которым нужны данные. (Например, если вас интересуют конкретные конкуренты, а не все, что попали в выдачу).
При добавлении домена проекта метод возвращает данные по домену проекта и его зеркалам.
Если указать домен зеркала — возвращает данные только по указанному домену.
Дополнительно ответ может быть отсортирован по одному из следующих параметров:
  • домен по алфавиту;
  • распределение трафика (если сортировка не указана, по умолчанию от большего к меньшему);
  • средняя позиция (органика);
  • средняя позиция в верхнем блоке (для контекста);
  • средняя позиция в боковом блоке (для контекста);
  • средняя позиция в нижнем блоке (для контекста);
  • количество фраз проекта, по которым домен встретился в выдаче (для органики);
  • количество фраз, по которым домен вне топа (для органики);
  • количество фраз проекта, по которым домен встретился в рекламе (для контекста);
  • количество фраз проекта, по которым домена не было в контексте (для контекста);
  • количество фраз проекта, по которым не было контекста в выдаче (для контекста);
  • количество объявлений в выдаче по домену (только для контекста);
  • количество фраз, по которым домен был в верхнем блоке рекламы (для контекста);
  • количество фраз, по которым домен был в боковом блоке рекламы (для контекста);
  • количество фраз, по которым домен был в нижнем блоке рекламы (для контекста).
А если сортировка не указана, тогда домены будут отсортированы от большего к меньшему по параметру «Распределение трафика».

Размер пагинации: 20, 50, 100, 200, 500 результатов на странице. Если не указать, по умолчанию в 1 странице ответа будет 100 результатов.

Данные можно будет получить как по органическим регионам, так и по контекстным.

Ответ представляет собой массив доменов, в каждом из которых есть список дат с данными по каждой из них.

Пример запроса:
{
    "id": "1",
    "method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
   "params": {
        "projectId": 651696,
        "projectRegionId": 249084,
        "page": 1,
        "pageSize": 20,
        "dateFrom": "2020-08-27",
        "dateTo": "2020-08-28",
        "sort": "domain",
        "order": "asc",
        "domains": [
            "fursk.ru",
            "ozon.ru"
        ]
    }
}
Хотите узнать, как использовать API Serpstat для отслеживания позиций?

Заказывайте бесплатную персональную демонстрацию сервиса, и наши специалисты вам все расскажут! ;)

Метод #3: Получение истории выдачи в регионе по ключевым фразам (getKeywordsSerpResultsHistory)
Процедура представляет собой аналог отчета История выдачи.

Метод работает только по одному региону и только по органическим регионам. Если вы хотите получить выдачу по нескольким регионам для данной ключевой фразы, нужно будет сделать несколько запросов с разными регионами.
Если вы не указываете даты, то метод вернет данные за последние 30 дней.
Получить данные за период более 30 дней в одном запросе нельзя. Если нужен период больше, то можно разбить на несколько отдельных запросов.
Пользователь может не указывать ключевые фразы, тогда в результате ему вернется ответ по 1000 ключевых фраз из проекта, по алфавиту от А до Я.
Если нужно получить ответ больше чем по 1000 ключевых фраз — необходимо будет разбить запрос и в каждом отправить группу ключевых фраз.
В ответе вы получите массив ключевых фраз, в котором по каждой фразе будет история выдачи, а за каждую дату будет топ выдачи. В Google это топ-100 позиций, в Яндексе — топ-50.
Дополнительно ответ может быть отсортирован:
  • по дате от новой к старой (по умолчанию) и наоборот;
  • по ключевой фразе по алфавиту.
Размер пагинации: 20, 50, 100, 200, 500 результатов на странице. Если не указать по умолчанию в 1 странице ответа, будет 100 результатов.

В ответе вернется массив ключевых фраз, по которым запросили топы.
Внутри каждого ключа — список дат с пробивками по проекту, в рамках запрашиваемого периода. И по каждой дате — топ выдачи, состоящий из позиции и URL.

Пример запроса:
{
    "id": 1,
    "method": "RtApiSerpResultsProcedure.getKeywordsSerpResultsHistory",
    "params": {
        "projectId": 715910,
        "projectRegionId": 262189,
        "page": 1,
        "pageSize": 500,
        "dateFrom": "2020-05-19",
        "dateTo": "2020-05-21",
        "sort": "date",
        "order": "asc",
        "keywords": ["1"]
    }
}

Метод #4: Получение списка страниц и их позиций по домену (getUrlsSerpResultsHistory)
Процедура является аналогом объединенных отчетов «Страницы» и «Ключевые фразы». Позволяет получить в разрезе 1 региона все позиции искомого домена, а не только лучшую.
Можно указывать конкретный домен, по которому нужны данные. Например, домен своего конкурента. Если домен не указывать, то в ответе по умолчанию приходят данные по домену проекта. Дополнительно можно получить результаты отдельной страницы.
Если вам не нужны данные по всему домену, то в запросе можно указать URL и получить информацию только по нему.
Можно указать до 1000 ключевых фраз из проекта.
Если пользователю необходимо больше — надо отправить несколько запросов с разными группами ключевых фраз.
Если не указать ключевые фразы, то будут выбраны 1000 фраз, отсортированных по алфавиту от А до Я.
Можно указать период, за который нужны данные.
Если не указывать, то вернутся данные за последние 30 дней от последней пробивки.
Ответ можно отсортировать по следующим параметрам (по умолчанию ключевые фразы будут отсортированы по алфавиту от А до Я):
  • по ключевой фразе по алфавиту;
  • по дате от новой к старой.
Размер пагинации: 20, 50, 100, 200, 500 результатов на странице. Но если размер страницы не указывать, по умолчанию будет 100 результатов на странице.
Вы получите в ответе массив ключевых фраз, по которым запрашивали результат. В каждой ключевой фразе идет история из дат, указанного периода.
За каждую дату по указанному домену вы получите позицию и URL, который встретился в топе выдачи.
Если был запрос на результат по контекстному региону, то будет еще отдельно параметр, указывающий на рекламный блок, в котором встретилось объявление.

Пример запроса:
{
    "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": "https://www.avito.ru/rsmarket24/rossiya/bytovaya_tehnika/dlya_kuhni/holodilniki_i_morozilnye_kamery?s_trg=7&s=1&utm_source=yandex&utm_medium=cpc&utm_campaign=holodilniki_avito_poisk&utm_term=авито холодильник&roistat=direct2_search_7016883518_авито холодильник&roistat_referrer=none&roistat_pos=premium_1&yclid=2444208711193363538"
    }
}

Для каких тарифных планов будет доступно API
API Мониторинга позиций доступно для пользователей таких тарифных планов:
Standard
Advanced
Enterprise

Вместо заключения
Как вы уже успели понять, API Мониторинга значительно расширяет ваши возможности для отслеживания позиций, ускоряет работу и не тратит лимиты. С его помощью вы можете быстро получить все нужные данные, настроить ряд запросов с разными наборами параметров и использовать данные для построения собственных дашбордов. А это только первая версия, поэтому, то ли еще будет ;)
Задавайте вопросы в комментариях или пишите в техподдержку :) А также вступайте в чат любителей Серпстатить и подписывайтесь на наш канал в Telegram.

Сэкономьте время на изучении Serpstat

Хотите получить персональную демонстрацию сервиса, тестовый период или эффективные кейсы использования Serpstat?

Оставьте заявку и мы свяжемся с вами ;)

Оцените статью по 5-бальной шкале

5 из 5 на основе 53 оценок
Нашли ошибку? Выделите её и нажмите Ctrl + Enter, чтобы сообщить нам.

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

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

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

Или 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
Сообщение
необязательно

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

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

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