Юлия Торчинская
Ноя 07, 2018 | Время чтения: 5 мин

Буквально на днях мы перезапустили наш 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/PPC

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

>

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

14) SEO-данные

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

Лимиты

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

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

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

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

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

БОЛЬШЕ ИНТЕРЕСНЫХ СТАТЕЙ
Новости
Обновления в SE Ranking: октябрь 2019
Ноя 11, 2019 Время чтения: 7 мин

В октябре мы полностью переделали «Анализ обратных ссылок», добавили новые Яндекс базы, интеграцию с Google Data Studio и по мелочи дополнили другие разделы платформы. Что поменялось в сервисе и как всем этим пользоваться ― в нашем уже традиционном обзоре месяца.

Юлия Торчинская
Новости
Обновления в SE Ranking: сентябрь 2019
Окт 09, 2019 Время чтения: 7 мин

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

Татьяна Мельниченко
Новости
Теперь в базы SE Ranking можно добавить свои ключевые слова
Окт 04, 2019 Время чтения: 3 мин

Сервисов SEO-аналитики, которые бы покрывали все ключевые слова в мире, не существует. От этого особенно страдают нишевые бизнесы, которые продвигаются по НЧ запросам. Чтобы каждый пользователь, независимо от специфики своего продукта, мог получить данные по нужным ключам, мы добавили функцию «Расширение базы».

Стася Аветисян