Інтеграція 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 ручний парсинг:

Економія на ручному зборі даних може сягати 400 000 рублів на рік для команди з 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