API для автоматического аудита сайтов под ИИ и GEO
Встраивайте движок AIRA в свои сервисы и процессы. Запускайте аудит AI-готовности сайтов программно и получайте структурированные отчеты через API.
Подходит SEO-агентствам, digital-компаниям, SaaS-платформам, веб-студиям и командам, которым нужно регулярно проверять десятки, сотни или тысячи сайтов.
Server-to-server API · JSON · Bearer authentication · Предоплаченные кредиты
Запрос
curl -X POST https://engine.aisearchtune.com/api/v1/audits \
-H "Authorization: Bearer aira_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"websiteUrl": "https://example.com", "reportLevel": "basic"}'Ответ 202
{
"auditId": "aud_4f1c2b7a9d8e4f0a8c6b5d4e3f2a1b0c",
"status": "queued",
"creditsCharged": 1,
"creditsRemaining": 41
}Что можно автоматизировать через AIRA API
Запуск аудита по URL
Отправьте адрес сайта — AIRA поставит аудит в очередь и вернет его идентификатор.
Отслеживание статуса
queued → running → completed или failed: простая статусная модель для опроса.
Отчет в JSON
Структурированный отчет для вашего интерфейса, CRM или SaaS — без парсинга HTML.
Пакетные проверки
Проверяйте сайты списками: клиентские портфели, каталоги, сети сайтов.
Встраивание в продукт
Агентский кабинет, SEO-инструмент, BI-дашборд или клиентский портал поверх движка AIRA.
Контроль расхода
Предоплаченные кредиты: 1 кредит = 1 аудит, остаток виден программно через API.
Кому нужен AIRA API
SEO и GEO-агентства
Массовые проверки клиентских сайтов и первичная диагностика AI-готовности.
Digital и веб-агентства
Аудит под ИИ как собственная услуга в прайсе агентства.
SaaS и SEO-платформы
Модуль AI-аудита внутри собственного продукта.
Владельцы сетей сайтов
Регулярный контроль AI-готовности всего портфеля.
Enterprise
Аудит в pipeline, дашборды и контроль качества площадок.
Разработчики и интеграторы
Проверка после релиза, миграции или изменения контента.
Как работает API
- 1Получаете API-ключ→
- 2Отправляете URL сайта→
- 3AIRA запускает аудит→
- 4Проверяете статус→
- 5Получаете JSON-отчет
Обычно аудит занимает 1–5 минут.
Рекомендуемый интервал проверки статуса — не чаще одного раза в 15 секунд.
API, рассчитанный на реальную интеграцию
Server-to-server
Ключ живет на вашем сервере и не попадает в браузер.
Безопасные ключи
Bearer-аутентификация; ключ показывается один раз и хранится только хэшем.
Ротация ключей
У организации может быть несколько активных ключей — замена без простоя.
Возврат кредита
Если аудит завершился внутренней ошибкой AIRA, кредит возвращается автоматически.
Защита от повторного списания
Повторный запуск того же сайта при активном аудите не создает второй аудит и не списывает кредит.
Rate limits
60 запросов в минуту на ключ, запуск аудитов — до 10 в минуту.
Уровни отчетов
Basic
Массовая первичная диагностика и определение уровня AI-готовности сайта.
Full
По договору — для глубокого анализа и полного отчета со всеми рекомендациями.
Допустимый reportLevel определяется условиями договора вашей организации.
Стоимость API
API работает по предоплаченной кредитной модели. 1 кредит = 1 аудит.
Full API
Стоимость зависит от объема и уровня отчета. Свяжитесь с нами — подберем условия под ваш сценарий интеграции.
Обсудить Full APIКак устроены кредиты
- ✓Кредиты оплачиваются заранее — вы всегда знаете бюджет на проверки.
- ✓Постановка аудита в очередь списывает 1 кредит.
- ✓При нулевом балансе аудит не запускается — случайный перерасход невозможен.
- ✓Если аудит завершился внутренней ошибкой AIRA, кредит возвращается автоматически.
- ✓Остаток кредитов доступен программно — через GET /account.
Начать интеграцию просто
POST /auditsзапустить аудит сайтаGET /audits/{auditId}статус аудитаGET /audits/{auditId}/reportготовый отчет в JSONGET /accountаккаунт и остаток кредитовОбсудить API-доступ
Расскажите, как вы хотите использовать AIRA API. Мы подберем уровень отчета, объем кредитов и условия подключения.
Вопросы об AIRA API
Что такое AIRA API?+
Программный интерфейс движка AIRA: вы запускаете аудит AI-готовности сайта HTTP-запросом и получаете структурированный JSON-отчет — тот же аудит, что на сайте, но внутри ваших процессов.
Для чего использовать AIRA API?+
Массовые и регулярные проверки сайтов, аудит как услуга в агентстве, модуль AI-аудита в SaaS-продукте, контроль сетей сайтов и проверки в релизных процессах.
Сколько занимает один аудит?+
Обычно 1–5 минут. Рекомендуемый интервал опроса статуса — не чаще одного раза в 15 секунд.
Как оплачивается API?+
Предоплаченными кредитами: 1 кредит = 1 аудит в рамках уровня доступа вашего договора. Кредиты начисляет менеджер.
Что будет, если аудит завершится ошибкой?+
Если аудит завершился внутренней ошибкой AIRA, кредит возвращается автоматически — вы не платите за наш сбой.
Есть ли Full-отчеты через API?+
Да, по договору: уровень Full подключается индивидуально и открывает полный отчет с рекомендациями.
Можно ли вызывать API из браузера?+
Нет. API рассчитан на вызовы сервер-сервер: CORS не открыт, а ключ не должен попадать на клиентскую сторону.
Какие лимиты у API?+
60 запросов в минуту на ключ и до 10 запусков аудитов в минуту. При превышении API отвечает 429 с заголовком Retry-After.