Інтеграція 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