Интеграция SEMrush API для SEO-аналитики сайта

Интеграция SEMrush API для SEO-аналитики сайта

Представьте: вы ведёте SEO для 10 доменов. Каждую неделю вручную открываете SEMrush, экспортируете отчёты, склеиваете CSV в Excel. На это уходит полдня, а в данных то и дело закрадываются опечатки. Для интернет-магазина с 100 000 товаров ручной сбор позиций всех категорий практически нереален — данные устаревают быстрее, чем вы их собираете. SEMrush API решает эту проблему раз и навсегда: программно забираете позиции, органику, бэклинки и метрики конкурентов, складываете в свою базу и строите дашборд. Автоматизация через API в 24 раза быстрее ручного сбора — экономия 90% времени. Мы реализовали такие интеграции для 8 проектов, включая мониторинг 50+ доменов ежедневно. Наш стек: Python 3.11, PostgreSQL 16, Docker, Grafana. Код передаём в виде репозитория с документацией.

Почему стоит автоматизировать сбор данных?

Ручной сбор из SEMrush — это часы рутины и риск ошибок при копировании. API даёт доступ к тысячам ключевых слов за один запрос, автоматическое обновление метрик по расписанию и возможность сравнивать 20+ доменов в едином дашборде. SEMrush API vs ручной парсинг:

Экономия на ручном сборе данных может достигать $3.6k–5.2k в год для команды из 3 человек — за счёт высвобождения времени на стратегический анализ.

Как управлять расходами API units?

Расход units напрямую зависит от объёма запросов. Оптимизация: для ежедневного мониторинга достаточно запрашивать только ключевые метрики (позиции топ-200, трафик, рейтинг домена). Полный backlink-аудит запускайте раз в неделю. При тарифе Business (10 000 units/мес) можно вести 5 доменов ежедневно. Используйте кэширование — не запрашивайте одни и те же данные повторно в течение дня.

Что делать при ошибках интеграции?

API может возвращать ошибки при превышении лимита, неверном ключе или временных сбоях. Код клиента должен обрабатывать их: при статусе ERROR проводить повторную попытку с экспоненциальной задержкой. Настройте алерты в Telegram или Slack при сбое сбора данных. Это гарантирует, что пропусков метрик не будет.

Как настроить клиент для SEMrush API?

SEMrush использует API-ключ как query-параметр. Ответ по умолчанию в CSV, но для некоторых эндпоинтов доступен JSON. Базовая реализация клиента на Python выглядит так:

import requests
import csv
import io
from typing import Literal

class SemrushClient:
    BASE_URL = 'https://api.semrush.com'
    ANALYTICS_URL = 'https://api.semrush.com/analytics/v1'

    def __init__(self, api_key: str):
        self.api_key = api_key
        self.session = requests.Session()

    def _request(self, params: dict) -> list[dict]:
        params['key'] = self.api_key
        resp = self.session.get(self.BASE_URL, params=params, timeout=30)
        resp.raise_for_status()
        if resp.text.startswith('ERROR'):
            raise ValueError(f'SEMrush API error: {resp.text}')
        reader = csv.DictReader(io.StringIO(resp.text), delimiter=';')
        return list(reader)

Основные эндпоинты API

Для сбора органики, конкурентов и бэклинков используем следующие методы. Сводка по затратам API units:

Пример получения органических ключевых слов домена:

def get_organic_keywords(self, domain: str, database: str = 'ru', limit: int = 1000) -> list[dict]:
    params = {
        'type': 'domain_organic',
        'domain': domain,
        'database': database,
        'display_limit': limit,
        'display_sort': 'tr_desc',
        'export_columns': 'Ph,Po,Pp,Nq,Tr,Ur',
    }
    return self._request(params)

Ответ содержит ключевые поля: Ph — ключевое слово, Po — позиция, Nq — месячный объём поиска, Tr — расчётный трафик, Ur — URL страницы.

Для backlink-аудита используем:

def get_backlinks(self, target: str, limit: int = 1000) -> list[dict]:
    params = {
        'type': 'backlinks',
        'target': target,
        'target_type': 'root_domain',
        'display_limit': limit,
        'display_sort': 'page_ascore_desc',
        'export_columns': 'source_url,target_url,anchor,page_ascore,domain_ascore,nofollow,first_seen',
    }
    return self._request(params)

Ежедневный сбор данных и хранение

Организуем пайплайн: по расписанию (например, cron) запускается скрипт, который собирает метрики домена, топ-200 ключевых слов, и сохраняет всё в PostgreSQL. Пример схемы:

CREATE TABLE semrush_domain_metrics (
    id SERIAL PRIMARY KEY,
    domain TEXT NOT NULL,
    snapshot_date DATE NOT NULL,
    organic_keywords INTEGER,
    organic_traffic INTEGER,
    semrush_rank INTEGER,
    UNIQUE(domain, snapshot_date)
);

CREATE TABLE semrush_keyword_positions (
    id SERIAL PRIMARY KEY,
    domain TEXT NOT NULL,
    keyword TEXT NOT NULL,
    position INTEGER,
    search_volume INTEGER,
    url TEXT,
    snapshot_date DATE NOT NULL,
    UNIQUE(domain, keyword, snapshot_date)
);

Пошаговая настройка интеграции

Чтобы автоматизировать сбор данных, выполните следующие шаги:

1. Получите API-ключ в панели SEMrush (раздел API).
2. Установите зависимости: pip install requests psycopg2-binary.
3. Реализуйте класс SemrushClient как показано выше.
4. Создайте таблицы в PostgreSQL по приведённой схеме.
5. Настройте cron-задачу для ежедневного запуска скрипта.
6. Интегрируйте метрики в Grafana для визуализации.

Что входит в работу

Наша интеграция включает:

• Код клиента на Python с обработкой ошибок и пагинацией.
• Скрипты для сбора данных по расписанию.
• Схему PostgreSQL для хранения метрик.
• Документацию по запуску и настройке.
• Настройку дашборда в Grafana (опционально).
• Поддержку после внедрения при обнаружении ошибок.

Расчёт API units

Для ежедневного мониторинга 5 доменов (метрики + 200 ключевых слов) расход примерно 500–700 units в день. При тарифе Business (10 000 units/мес) это укладывается в лимит. Оптимизация: не запрашивать полные списки бэклинков ежедневно, только ключевые метрики. Полный backlink-аудит — раз в неделю.

Сроки и стоимость

Базовая интеграция с ежедневным сбором метрик одного домена и топ-200 ключевых слов — 2–3 рабочих дня. Расширенная версия с конкурентным анализом, backlink-аудитом и дашбордом в Grafana — 5–7 дней. Стоимость рассчитываем индивидуально после аудита ваших задач. Получите консультацию — свяжитесь с нами, чтобы оценить проект. Закажите интеграцию сегодня и начните экономить время и ресурсы.

Мы гарантируем качество: код покрыт тестами, настроены алерты при ошибках сбора, предоставляем поддержку после внедрения. Наш опыт — 5+ лет в веб-разработке и SEO-интеграциях, реализовано 8 проектов с суммарным мониторингом 50+ доменов.

SEMrush API Documentation