v1 stable · 99.95% uptime

audit4seo API

Интегрируйте SEO-аудит и мониторинг позиций в свои продукты: CRM, дашборды агентств, личные кабинеты клиентов, AI-ассистентов. REST + JSON, 5 минут до первого запроса.

Endpoints

Что доступно через API

Полный набор операций: запуск аудита, чтение результатов, управление проектами и проверка позиций.

POST
/api/v1/audit

Запустить новый аудит сайта. Возвращает audit_id для опроса. Среднее время выполнения — 30–45 секунд.

GET
/api/v1/audit/{id}

Получить результаты завершённого аудита: SEO Health Score, список проблем по категориям, AI-план исправлений.

GET
/api/v1/projects

Список всех ваших проектов с актуальным статусом, последним аудитом и количеством отслеживаемых ключей.

GET
/api/v1/positions/{project_id}

Текущие позиции по всем отслеживаемым ключевым запросам в Яндексе и Google. История за последние 90 дней.

POST
/api/v1/positions/check

Разовая проверка позиций по списку ключевых запросов без создания проекта. Удобно для скоринга и пайчей.

Лимиты

Тарифы для API

Все лимиты — суточные, обновляются в 00:00 МСК. Concurrency — максимальное число параллельных запросов от одного ключа.

Тариф Запросов в день Concurrency Webhook Цена
Соло 10 1 490 ₽/мес
Бизнес Топ 100 2 да 1 490 ₽/мес
Агентство 10 000 10 да + retry 4 990 ₽/мес
Аутентификация

Bearer-токен в заголовке

Один ключ на аккаунт, можно создавать дополнительные с ограниченными правами.

Как авторизоваться

Передавайте API-ключ в заголовке Authorization любого запроса:

Authorization: Bearer YOUR_API_KEY

Получить ключ можно в Личном кабинете → Настройки → API. После регистрации первый ключ создаётся автоматически. Если ключ скомпрометирован — отзовите его в кабинете и сгенерируйте новый.

Пример

Запуск аудита через cURL

Минимальный запрос — нужен только URL. Ответ возвращает audit_id, который потом запрашиваем GET-ом.

bash · request
# Запустить аудит сайта curl -X POST https://audit4seo.ru/api/v1/audit \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com"}'
Ответ API

JSON с результатами

Композитный score 0–100, массив проблем с severity и список AI-рекомендаций.

json · response
{ "audit_id": "a4s_2026Xv8Q9mK3", "domain": "example.com", "status": "completed", "score": 67, "checked_at": "2026-04-26T08:14:00Z", "duration_ms": 31420, "issues": [ { "id": "lcp_too_slow", "severity": "high", "category": "speed", "value": "4.2s", "threshold": "2.5s", "affected_pages": 1, "ai_fix": "Defer non-critical CSS, preload hero image, use width/height attrs..." }, { "id": "broken_links", "severity": "high", "category": "structure", "count": 12 } ], "ok": ["robots_txt", "mobile_friendly", "https", "canonical"], "report_url": "https://audit4seo.ru/r/a4s_2026Xv8Q9mK3" }
Webhooks

Уведомления о событиях

Регистрируете URL в кабинете — отправляем POST-запрос при наступлении события. Подпись HMAC-SHA256 в заголовке X-A4S-Signature.

audit.completed

Аудит завершён, отчёт готов к чтению. Содержит audit_id, score и report_url.

audit.failed

Аудит не удалось выполнить (сайт недоступен, тайм-аут, отказ в доступе). Содержит код ошибки и описание.

positions.changed

Заметное изменение позиций (≥3 пункта вверх/вниз) по отслеживаемым ключевым запросам.

health.degraded

SEO Health Score сайта упал на 5+ пунктов с прошлого аудита — требуется внимание владельца.

MCP-сервер для AI-ассистентов soon

Подключите audit4seo как Model Context Protocol-инструмент в Claude, Cursor, Windsurf или собственного агента. Тогда LLM сможет сам запускать аудит, читать отчёты и предлагать клиенту план исправлений в режиме диалога. Готовится к выпуску — оставьте email на странице тарифов, чтобы получить ранний доступ.

Готовы интегрировать?

Получить API-ключ

Для тарифа «Соло» — 10 запросов в день бесплатно (после триала). Для «Бизнеса» и «Агентства» — webhooks и расширенные лимиты.

Зарегистрироваться Сравнить тарифы