Юлия Торчинская
Ноя 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!

БОЛЬШЕ ИНТЕРЕСНЫХ СТАТЕЙ
Новости
Зимние обновления в SE Ranking
Мар 07, 2019 Время чтения: 5 мин

Уже по традиции в конце каждого сезона мы готовим дайджест с обновлениями SE Ranking. Встречайте зимние апдейты – 10 новых баз в "Анализе конкурентов в SEO/PPC", добавление тегов в позициях, анализ дополнительных параметров в "Мониторинге топ-100" и другие обновления нашей платформы.

Юлия Торчинская
Новости
SE Ranking в ТОП-50 Best Software Awards 2019 вместе с HubSpot, Shopify и PayPal
Фев 13, 2019 Время чтения: 3 мин

2019-й год начался для нас как нельзя лучше – SE Ranking сразу в двух рейтингах Best Software Awards 2019 от G2 Crowd. Мы очень гордимся тем, что вошли в ТОП-50 наиболее быстрорастущих компаний и ТОП-50 лучших софтов для малого бизнеса. На платформе G2 Crowd представлено более 45 000 компаний, и быть выбранными среди них в списки лучших это как получить “Оскар” в мире IT.

Юлия Торчинская
Новости
Мониторинг топ-100 – полный контроль выдачи по вашим запросам
Фев 11, 2019 Время чтения: 6 мин

Есть множество инструментов для мониторинга позиций сайта (своего или конкурента). Мы же предлагаем уникальный модуль для контроля сразу всей выдачи – точнее, ста первых ее результатов. Рассказываем, какие функции у «Мониторинг топ-100» и какие задачи он помогает решить.

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