Главная → API

API сервиса

Отчёт можно получать в JSON тем же способом, каким его получает сама страница: обычным HTTP-запросом. Без ключа, без регистрации. Кнопка «Скачать JSON» в отчёте отдаёт ровно тот объект, который описан ниже.

Полный аудит: POST /api/audits

Запускает полный аудит страницы (52 правил) и возвращает готовый отчёт. Запрос синхронный: ответ приходит после завершения проверки, обычно за 15–60 секунд.

curl -X POST https://seodiagnoz.ru/api/audits \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.ru/"}'

Ключевые поля ответа:

• scores.overall — балл 0–100, тот же, что на экране.
• findings — находки: правило, статус (pass / warn / fail / info / skipped), срочность, формулировка и рекомендация, доказательства.
• counts и coverage — сколько проверок прошло, сколько нашло проблемы, сколько пропущено.
• report_url — постоянная ссылка на отчёт, живёт 180 дней.

Готовый отчёт можно перечитать по GET /api/audits/{id}, где id — хвост из report_url.

Одна проверка: POST /api/checks

Запускает один инструмент вместо полного аудита. Имя инструмента совпадает с адресом его страницы в каталоге: например, странице /proverki/dlina-title/ соответствует "tool": "dlina-title".

curl -X POST https://seodiagnoz.ru/api/checks \
  -H 'Content-Type: application/json' \
  -d '{"tool": "dlina-title", "url": "https://example.ru/"}'

Инструменты с режимом «проверить текст» принимают вместо url поле text (до 120 000 символов): черновик проверяется без публикации, сервис при этом не ходит в сеть.

Справочники и лимиты

• GET /api/rules — список всех правил с формулировками и основаниями (документация Яндекса и Google у каждого).
• Полный аудит: 20 в час и 100 в сутки с одного IP, 12 в час на проверяемый домен.
• Одиночные проверки: 120 в час с одного IP, 60 в час на домен.
• При превышении приходит 429 с полем retry_after (секунды до сброса окна).

Формат без номера версии: он меняется тогда, когда меняется сам отчёт. Ломающие изменения стараемся не делать, но SLA у бесплатного сервиса нет. Вопросы и интеграции — info@seodiagnoz.ru.