Как отслеживать позиции сайта через API: новые методы в API Serpstat для Мониторинга позиций
Максим Астахов
Product/Project manager at Serpstat
API Мониторинга позиций — новый и важный шаг в развитии нашего сервиса. Публичные методы API дают пользователям свободу действий и понятный флоу в работе с данными. Кроме того, API Мониторинга не будет тратить ваши лимиты, а полнота данных будет соответствовать интерфейсу, а в некоторых случаях даст возможность получить даже больше информации.
Например, сейчас в отчете «Ключевые фразы» мы показываем только лучшую позицию домена, а при помощи метода API можно будет увидеть все позиции домена по выбранной ключевой фразе.
Например, сейчас в отчете «Ключевые фразы» мы показываем только лучшую позицию домена, а при помощи метода API можно будет увидеть все позиции домена по выбранной ключевой фразе.
Сегодня я расскажу о том, что такое API Мониторинга позиций, как оно работает, не затрачивая лимиты, и какие данные отдает. Начнем :)
Что такое API Мониторинга позиций
API (программный интерфейс приложения, интерфейс прикладного программирования) — это способ получения данных, который помогает быстро получать большие объемы информации без использования интерфейса Serpstat. Также он позволяет интегрировать аналитику сервиса в свои внутренние инструменты.
API Serpstat касается модулей «Анализ сайта», «Анализ ключевых фраз», «Анализа ссылок», «Аудит сайта», «Мониторинг позиций». Среди наших клиентов API используют крупные и малые бизнесы, агентства и независимые SEO-специалисты. В их числе Flatfy (от ЛУН), Netpeak, Inweb, SeoMarket, Ingate, WebX.page, Masgroup.
Предоставляемый функционал сэкономит ваше время. К тому же в блоге есть множество обучающих материалов. Они помогут разобраться с инструментом специалистам, которые не умеют программировать, но хорошо гуглят ;)
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 метода, но они позволят полноценно получить данные из всех отчетов вашего проекта в Мониторинге позиций.
В первой версии доступно 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 результатов.
Данные можно будет получить как по органическим регионам, так и по контекстным.
Ответ представляет собой массив доменов, в каждом из которых есть список дат с данными по каждой из них.
Пример запроса:
Размер пагинации: 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 позиций.
Дополнительно ответ может быть отсортирован:
- по дате от новой к старой (по умолчанию) и наоборот;
- по ключевой фразе по алфавиту.
Размер пагинации: 20, 50, 100, 200, 500 результатов на странице. Если не указать по умолчанию в 1 странице ответа, будет 100 результатов.
В ответе вернется массив ключевых фраз, по которым запросили топы.
Внутри каждого ключа — список дат с пробивками по проекту, в рамках запрашиваемого периода. И по каждой дате — топ выдачи, состоящий из позиции и URL.
Пример запроса:
В ответе вернется массив ключевых фраз, по которым запросили топы.
Внутри каждого ключа — список дат с пробивками по проекту, в рамках запрашиваемого периода. И по каждой дате — топ выдачи, состоящий из позиции и 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 дней от последней пробивки.
Если не указывать, то вернутся данные за последние 30 дней от последней пробивки.
Ответ можно отсортировать по следующим параметрам (по умолчанию ключевые фразы будут отсортированы по алфавиту от А до Я):
- по ключевой фразе по алфавиту;
- по дате от новой к старой.
Размер пагинации: 20, 50, 100, 200, 500 результатов на странице. Но если размер страницы не указывать, по умолчанию будет 100 результатов на странице.
Вы получите в ответе массив ключевых фраз, по которым запрашивали результат. В каждой ключевой фразе идет история из дат, указанного периода.
За каждую дату по указанному домену вы получите позицию и URL, который встретился в топе выдачи.
За каждую дату по указанному домену вы получите позицию и 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://bt.rozetka.com.ua/whirlpool-w7x-81o-ox-0/p346969209/"
}
}Для каких тарифных планов будет доступно API
API Мониторинга позиций доступно для пользователей таких тарифных планов:
Standard
Advanced
Enterprise
Вместо заключения
Как вы уже успели понять, API Мониторинга значительно расширяет ваши возможности для отслеживания позиций, ускоряет работу и не тратит лимиты. С его помощью вы можете быстро получить все нужные данные, настроить ряд запросов с разными наборами параметров и использовать данные для построения собственных дашбордов. А это только первая версия, поэтому, то ли еще будет ;)
Задавайте вопросы в комментариях или пишите в техподдержку :) А также вступайте в чат любителей Серпстатить и подписывайтесь на наш канал в Telegram.
Serpstat — набор инструментов для поискового маркетинга!
Находите ключевые фразы и площадки для обратных ссылок, анализируйте SEO-стратегии конкурентов, ежедневно отслеживайте позиции в выдаче, исправляйте SEO-ошибки и управляйте SEO-командами.
Набор инструментов для экономии времени на выполнение SEO-задач.
Нашли ошибку? Выделите её и нажмите Ctrl + Enter, чтобы сообщить нам.
Рекомендуемые статьи
Кейсы, лайфхаки, исследования и полезные статьи
Не успеваешь следить за новостями? Не беда! Наш любимый редактор подберет материалы, которые точно помогут в работе. Только полезные статьи, реальные кейсы и новости Serpstat раз в неделю. Присоединяйся к уютному комьюнити :)
Нажимая кнопку, ты соглашаешься с нашей политикой конфиденциальности.