Черная пятница в SE Ranking: 30% скидки на любую оплату. подробнее

Вход / Попробовать бесплатно
Выход / Проекты
Почему мы
BLACKFRIDAY2018

-30% скидки на любую оплату
подробнее

ЮлияЮлия
· 5 мин
0

Все о новом API от SE Ranking

Буквально на днях мы перезапустили наш API и с радостью представляем вам обновленный SE Ranking API. Это четвертая и на данный момент самая лучшая версия нашего API. Не удивляйтесь, что вы никогда не слышали о третьей версии – она пользуется популярностью только у наших разработчиков 🙂

Чем крута обновленная версия – теперь доступ через API открыт практически ко всем разделам онлайн-платформы (до этого был доступен только раздел “Позиции”); значительно упрощен процесс настройки и работы с интерфейсом. При этом довольно внушительный список разделов API будет расширяться и в дальнейшем.

Но давайте обо всем по порядку.

Зачем API

API (application program interface – программный интерфейс приложения) нужен для предоставления программного доступа к данным приложения. То есть, по сути, API позволяет работать с уже готовым кодом. Именно API помогает пользователям SE Ranking автоматизировать управление большими объемами данных вне интерфейса онлайн-платформы.

Без API не обойтись, если нужно быстро и эффективно управлять сложными или большими аккаунтами, настраивать их под свои потребности, просматривать, добавлять или удалять проекты.

Преимущества API от SE Ranking

Пользование API открывает такие возможности, как:

  • управление большими проектами;
  • получение только необходимых данных;
  • автоматизация работы с проектами;
  • создание комплексных аналитических отчетов;
  • использование данных SE Ranking для интеграции с различными бизнес-приложениями, виджетами и панелями.

В общем и целом, API – это функция, позволяющая в удобном формате управлять Big Data, с которой работают рекламные компании, диджитал-агентства, компании по маркетингу в поисковых системах, крупные бренды и т.д.

Как пользоваться

Алгоритм пользования API довольно простой.

  1. Достаточно иметь подписку на “Корпоративный” план или же пользоваться тарифом с оплатой за проверку. Стоимость одного запроса к модулю “SEO Данные” – 0,03 руб.
  2. Следующий шаг – сгенерировать API-ключ (токен) в аккаунте пользователя SE Ranking. Для этого нужно зайти в раздел “Настройки” -> API и нажать кнопку “Получить API-ключ”.новый API SE Ranking
  3. В этом же разделе можно изменить или удалить сгенерированный ключ.

Методы и формат данных

Взаимодействие с API происходит по протоколу HTTPS. Все вызовы методов – HTTP-запросы GET/POST/PUT/DELETE к URL: https://api4.seranking.com/

Все данные как принимаются, так и отдаются в кодировке UTF-8. Данные, передаваемые в теле POST/PUT запроса, имеют формат JSON.

Если запрос передан успешно, возвращается HTTP код 2xx. В случае ошибки возвращается HTTP 4xx или HTTP 5xx и описание самой ошибки.

API SE Ranking позволяет автоматизировать работу с проектами (создание, редактирование, удаление, получение статистики) и SEO-данными (получение ТОП 100 поисковой выдачи Google и Yandex (URL, сниппет, позиция сайта) по ключевым фразам без создания проекта в сервисе SE Ranking.

Варианты работы с API:

1) Проекты:

  • получить список всех проектов пользователя
  • получить список поисковых систем проекта
  • добавить (изменить, удалить)  поисковые системы в проект
  • получить список ключевых слов с целевыми страницами определенного проекта
  • получить сводную статистику по проекту
  • получить статистику проверки позиций по ключевым словам проекта за выбранный период.
  • добавить новые ключевые слова в проект
  • добавить новый проект в аккаунт пользователя
  • изменить/обновить настройки проекта
  • удалить проект из аккаунта пользователя
  • удалить ключевые слова из проекта
  • установить позиции для ключевых слов проекта
  • запустить проверку позиций для выбранных ключевых слов либо для всего проекта

2) Группы проектов

  • добавить (удалить) группу проектов в аккаунт пользователя
  • изменить название группы проектов
  • получить список всех групп проектов в аккаунте пользователя
  • перенести проекты из одной группы проектов в другую

3) Группы ключевых слов

  • добавить группу для ключевых слов проекта
  • перенести ключевые слова проекта из одной группы в другую
  • изменить название группы ключевых слов проекта
  • удалить группу ключевых слова проекта
  • получить список групп ключевых слов для указанного проекта

4) Конкуренты

  • добавить сайт конкурента в проект для отслеживания позиций
  • получить список всех конкурентов добавленных в проект
  • получить статистику проверки позиций по ключевым словам конкурента, добавленного в проект
  • удалить сайт конкурента из проекта пользователя
  • получить список результатов из ТОП-10 по ключевым словам, отслеживаемым в проекте
  • получить список результатов из ТОП-100 по ключевым словам, отслеживаемым в проекте
  • получить информацию о сайтах, которые были в ТОП-10 по каждому из отслеживаемых запросов

5) Теги URL

  • получить список тегов сайта, которые привязываются к доменам и (или) ссылкам
  • добавить тег к сайту и привязать его к ссылке и (или) домену, если они были переданы
  • назначить теги домену и (или) ссылке
  • удалить теги

6) Аналитика и трафик

  • получить популярные запросы из Google Search Console
  • получить популярные запросы из Яндекс.Вебмастер
  • оценить потенциальное количество трафика
  • оценить потенциальную стоимость трафика, если бы он покупался в Google Ads
  • оценить потенциальное количество клиентов

7) Аккаунт

  • получить баланс аккаунта пользователя

8) Общие данные

  • получить список доступных поисковых систем, которые можно добавить в проекты для отслеживания позиций, с возможными регионами
  • получить список доступных регионов для поисковой системы Яндекс
  • получить полный список возможных языков для поисковой системы Google
  • получить список всех регионов, по которым можно проверить частотность в онлайн-сервисе SE Ranking
  • получить частотность для указанного региона и списка ключевых слов

9) Маркетинг-план

  • получить список разделов, пунктов и информацию об отметках плана
  • добавить (изменить, удалить) задачу
  • установить статус задачи

10) Бизнес-каталоги

  • получить список регионов, для которых собраны бизнес-каталоги
  • получить список ссылок для добавления
  • установить статус ссылки

11) Анализ сайта

  • получить статус аудита
  • получить данные по отчету аудита
  • получить список страниц по указанной проверке
  • получить историю по аудиту

12) Бэклинки

  • получить статистику по бэклинкам
  • получить список бэклинков сайта
  • добавить (удалить) бэклинк

13) SEO-данные

  • добавить ключевое слово в очередь для получения ТОП 100 поисковой выдачи Google и Yandex (URL, сниппет, позиция сайта)
  • получить результат по ключевому слову, ранее добавленному в очередь
  • получить список всех запросов пользователя, которые были добавлены в очередь за последние 24 часа

Подробную документацию по API с примерами, равно как и коды возможных ошибок и статусов можно посмотреть по ссылке.

Лимиты

Количество запросов к API не ограничено, лимит установлен только на скорость отправки запросов. Такие меры необходимы для успешной работы API для всех юзеров.

Основное ограничение состоит в том, чтобы не делать запросы чаще 5 раз в секунду. При превышении количества запросов сервер покажет, что приложению нужно уменьшить скорость. Если же лимит будет превышаться длительное время, доступ к API будет заблокирован на 10 минут. При этом время блокировки будет увеличиваться после каждого последующего превышения лимитов.

Работать с API намного быстрее и эффективнее, чем делать ту же работу вручную. API от SE Ranking – это отличная возможность автоматизировать работу с большими проектами и объемами SEO-данных, получая точную информацию в удобном вам формате.

ПОДЕЛИТЬСЯ

КОММЕНТАРИИ

    1. Вы можете найти как примеры запросов, так и ответов для каждого метода в документации по API – https://seranking.ru/api-methods.html. Как только у нас будут юскейсы, обещаем поделиться. Также будем очень рады, если вы напишите, как используете API!

Send this to a friend