Идеальный инструмент для бизнеса

API-разведка SEMrush

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

Почему API?

  • Анализируйте большие объемы информации с молниеносной скоростью. Выбирайте и анализируйте только ту информацию, которая относится к оптимизации именно вашего сайта, вместо того чтобы часами просматривать огромное количество данных.
  • Улучшите свой софт. Наш API разработан с учетом возможности легкой интеграции в любое приложение, виджет или панель инструментов. О позволяет визуализировать наши данные через настроенный пользовательский интерфейс, а также удобен при использовании платформ электронной коммерции таких, как Magento, Shopify, Drupal, PrestaShop и многих других.
  • Получите выгоду от ценных данных. Анализируйте стратегии конкурентов в органическом и платном поиске, их дисплейную рекламу и обратные ссылки. Запускайте проекты по отслеживанию ключевого слова или домена для любого местоположения и получайте ежедневный обновления по изменению поискового рейтинга сайтов. 

С чего начать?

Готовы интегрировать SEMrush API? Он заработает буквально через несколько простых шагов.

  1. Обновите свой тарифный план на Business.
  2. Купите пакет API, подходящий под ваши задачи
  3. Получите API ключ Получить API

Что внутри?

  • 120,000,000 ключевых слов
  • 427,000,000 доменов
  • 135 баз данных по 118 странам
  • 16 языков
  • Архивные данные с 2012 *
  • 39,675,000,000,000 обратных ссылок

  1. Архивные данные доступны на тарифном плане Guru и выше.
  2. Архивные данные, собранные с 2012 года, доступны только для американских баз данных. Архивные данные других баз данных доступны с более позднего времени. 

Сколько API-юнитов (units) вам понадобится?

Мы различаем три вида запросов, поступающих через SEMrush API: линейный, на действие и на ключевые слова. Линейный запрос подразумевает загрузку данных из различных отчетов. Запрос на действие может быть использован для создания, обновления или удаления проекта. Если вам нужно добавить новые термины в кампанию по отслеживанию ключевых слов, вам следует применить запрос на ключевые слова. В этом случае за каждое новое ключевое слово будет взыматься дополнительная плата.

Стоимость запросов измеряется в юнитах (units). Количество юнитов определяются типом отчета или запроса. Предоставление актуальных данных требует задействовать больше юнитов, чем предоставление архивных данных. Один доллар равняется примерно 20 000 юнитам API.

К примеру, один набор данных в отчете Organic Keywords cтоит 10 юнитов за актуальные результаты и 50 юнитов за архивные данные. Если вы хотите сделать список из 1000 органических ключевых слов для 100 доменов, вам придется заплатить за 1 000 000 и 5 000 000 юнитов соответственно (1,000 ключевых слов * 10 API юнитов для актуальных данных * 100 доменов = 1,000,000 юнитов; 1,000 ключевых слов *50 API юнитов для архивных данных * 100 доменов= 5,000,000 юнитов).

Рекомендуется просчитать ваш лимит на запросы API прежде чем покупать пакет API. Вы можете увеличить свой лимит запросов, перейдя на другой тарифный план или купив дополнительные юниты API 

SEMrush API v4.0

Версия SEMrush API v4.0 предназначается для приложений, зарегистрированных в Сервисе аутентификации SEMrush (Google Data Studio, Zapier, etc.)

Если вы хотите воспользоваться этим API, свяжитесь с нами

Конечная точка (Endpoints)

https://api.semrush.com/apis/v4/

Формат ответа

В формулировке response body содержится JASON-объект, имеющий top-level object meta, за которым следует или объект данных (data object) или объект ошибки (error object), но не оба сразу. Ниже приводится объяснение каждого из этих атрибутов. 


Object meta

Пример успешного завершения запроса 

Error Object (Объект ошибки)

Пример неуспешного запроса

Авторизация

Введите токен авторизации в HTTP-заголовок запроса.

Authorization: Bearer **** 

Аудит сайта через API

GET A LIST OF CAMPAIGNS |ПОЛУЧИТЬ СПИСОК КАМПАНИЙ
Стоимость: 100 API-юнитов за запрос

Этот запрос позволяет вам получить список кампаний Siteaudit для вашей учетной записи.

Request method (Метод запроса)
GET

Endpoint (Конечная точка)
https://api.semrush.com/apis/v4/siteaudit/campaigns/

Response example (Пример ответа)
{

"data": {

"campaign_id": 123,

"status": "FINISHED"

}


 GET THE CAMPAIGN STATUS / ПОЛУЧИТЬ СТАТУС КАМПАНИИ
Стоимость: 100 API-юнитов за запрос

Этот запрос позволяет вам получить статус кампании по аудиту сайта через ID

Request method (Метод запроса)
GET

Endpoint (Конечная точка)
https://api.semrush.com/apis/v4/siteaudit/campaigns/{campaign_id:[0-9]+}/status

Response example (Пример ответа)
{

"data": {

"campaigns": [

{

"campaign_id": 123,

"name": "Campaign name",

"url": "campaign.url"

},

{

"campaign_id": 1234,

"name": "Campaign2 name",

"url": "campaign2.url"

}

]

}


GET A LIST OF TASKS FOR THE SITE AUDIT CAMPAIGN / ПОЛУЧИТЬ СПИСОК ЗАДАЧ ДЛЯ КАМПАНИИ ПО АУДИТУ САЙТА
Стоимость: бесплатно

Этот запрос позволяет вам получить список задач для кампании по аудиту сайта.

Request method (Метод запроса)
GET

Endpoint (Конечная точка)
https://api.semrush.com/apis/v4/siteaudit/campaigns/{campaign_id:[0-9]+}/tasks

Response example (Пример ответа)
{

"data": {

"tasks": [

{

"id": "6133a19",

"title": "title",

"url": "http://example/",

"howToFix": "howToFix",

"comment": "comment"

}

]

}


GET OVERVIEW REPORT / ПОЛУЧИТЬ ОБЗОРНЫЙ ОТЧЕТ OVERVIEW REPORT
Стоимость: 10000 API-юнитов за запрос

Этот запрос позволяет вам получить обзорный отчет по аудиту сайта.

Request method (Метод запроса)
GET

Endpoint (Конечная точка)
https://api.semrush.com/apis/v4/siteaudit/campaigns/{campaign_id:[0-9]+}/reports/overview

Response example (Пример ответа)
{

"data": {

"campaign_id": 12345,

"name": "example",

"url": "example",

"status": "FINISHED",

"last_audit": 1590000000000,

"pages_crawled": 100,

"pages_limit": 100,

"summary": {

"errors": 6,

"warnings": 543,

"notices": 114,

"blocked": 2,

"redirected": 3,

"healthy": 11,

"have_issues": 84,

"have_issues_delta": 1,

"errors_delta": 2,

"warnings_delta": -13,

"notices_delta": -81

},

"current_snapshot": {

"quality": {

"value": 76,

"delta": 2

},

"thematic_scores": {

"https": {

"value": 99

},

"int_seo": {

"value": 100

},

"crawlability": {

"value": 94,

"delta": 4

},

"performance": {

"value": 98,

"delta": -2

},

"linking": {

"value": 96,

"delta": 2

}

}

}

}


CREATE А NEW SITE AUDIT CAMPAIGN / СОЗДАТЬ НОВУЮ КАМПАНИЮ ПО АУДИТУ САЙТА
Стоимость: 100 API-юнитов за запрос

Этот запрос позволяет вам создать новый проект и запустить кампанию по аудиту сайта.

Request method (Метод запроса)
POST

Endpoint (Конечная точка)
https://api.semrush.com/apis/v4/siteaudit/campaigns/

Request body

{

"name": "Example",

"pages_limit": 1000,

"start_crawl_url": "https://www.example.com/landing/"

}


Response example (Пример ответа)
{

"data": {

"project_id": 123

}


RE-CRAWL A SITE AUDIT CAMPAIGN / СДЕЛАТЬ РЕКРАУЛИНГ КАМПАНИИ ПО АУДИТУ САЙТА
Стоимость: 100 API-юнитов за запрос

Этот запрос позволяет вам запустить новый аудит сайта для уже существующей кампании.

Request method (Метод запроса)
POST

Endpoint (Конечная точка)
https://api.semrush.com/apis/v4/siteaudit/campaigns/{campaign_id:[0-9]+}/recrawl

Response example (Пример ответа)
{

"data": {

"campaign_id": 123,

"status": "RUNNING"

}


Traffic Analytics API

Руководство

Traffic Analytics API позволяет вам получать исходные данные из инструмента SEMrush Traffic Analytics.

Этот API доступен в двух вариантах:

Базовый: данные отчета Traffic Overview

Расширенный: включает Общий обзор трафика (Traffic Overview), источники трафика (Traffic Sources), маршруты трафика (Traffic Destinations), геораспредение (Geographic Distribution), субдомены (Subdomains), аудиторию (Audience), наиболее популярные страницы (Top pages), повышенный уровень точности данных (Accuracy level plus) и данные других отчетов



Важно: В дополнение к двум указанным планам существует индивидуальный пакет предложений и расценок, который вы можете получить, связавшись с нашими торговыми представителями по телефону или электронной почте: sales@semrush.com. 

Базовый план API

Обзор трафика (Traffic Overview) предоставит вам данные по поведению посетителей сайтов. В них включено количество посещений в месяц, уникальные посещения, количество страниц, просмотренных за одно посещение, средняя длительность посещения, процентное соотношение трафика для мобильных устройств и десктопов, а также процент отказов.

Обзорный отчет по трафику (Traffic Analytics Overview) поможет одновременно сравнить до 5 доменов по указанным параметрам, причем за один запрос. Эта информация раскроет общие данные о взаимодействии между вебсайтом и его аудиторией. 

Расширенный план API

Расширенный план API (см. детали в API documentation) предлагает воспользоваться четырьмя различными отчетами в дополнение к Обзору трафика (Traffic Overview) из базового плана:

  1. Источники трафика (Traffic Sources)
  2. Маршруты трафика (Traffic Destinations)
  3. Геораспределение (Geographic Distribution)
  4. Субдомены (Subdomains)

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

Вы сможете проанализировать источники трафика (поисковый, социальный, платный, реферальный или прямой), а также географическое расположение по всему миру, включая самые популярные социальные сети и поисковики, посылающие трафик на сайт. С помощью этой информации вы определите, откуда приходит основной поток посетителей.

Отчет Subdomains позволит понять, как структура сайта привлекает посетителей, а отчет Traffic Destinations покажет, на какие сайты пользователи переходят чаще всего после посещения изучаемого домена.

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

Если вы хотите узнать об остальных возможностях отчета Traffic Analytics Overview и других более детальных отчетов, прочитайте это Руководство пользователя по Traffic Analytics

Как получить API?

Traffic Analytics API от SEMrush доступен в рамках нескольких тарифных планов:

  • Базовый: предоставляет только сводные данные о трафике
  • Расширенный: предоставляет сводные данные о трафике наряду со всеми остальными данными

Ежемесячный лимит по умолчанию включает 10 000 запросов. Этот API не использует API-юниты (API units), применяемые в стандартном API для владельцев бизнес-подписки.


Если вы заинтересовались Traffic Analytics API, вы можете узнать больше на странице ‘Subscription info’. Наши менеджеры по адресу sale@digitalindex.ru также смогут подобрать специальное предложение с учетом ваших потребностей. 

С какими инструментами совместим Traffic Analytics API?

Данные Traffic Analytics API можно легко интегрировать в:

  • Инструменты бизнес-разведки (такие, как Tableau, Dundas BI, Domo, и др.)
  • Инструменты для визуализации данных (например Google Data Studio)
  • Электронные таблицы (Google Sheets или Microsoft Excel)
  • Персонализированные панели инструментов
  • Продукты SAAS

И это еще не все!


Чтобы встроить API в Google Sheets, следуйте  этим инструкциям. Официальную документацию Traffic Analytics API для разработчиков и конечных пользователей можно найти здесь

Как часто обновляются данные Traffic Analytics API?

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