AIRA Partner API

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. 1Получаете API-ключ
  2. 2Отправляете URL сайта
  3. 3AIRA запускает аудит
  4. 4Проверяете статус
  5. 5Получаете JSON-отчет

Обычно аудит занимает 1–5 минут.

Рекомендуемый интервал проверки статуса — не чаще одного раза в 15 секунд.

API, рассчитанный на реальную интеграцию

Server-to-server

Ключ живет на вашем сервере и не попадает в браузер.

Безопасные ключи

Bearer-аутентификация; ключ показывается один раз и хранится только хэшем.

Ротация ключей

У организации может быть несколько активных ключей — замена без простоя.

Возврат кредита

Если аудит завершился внутренней ошибкой AIRA, кредит возвращается автоматически.

Защита от повторного списания

Повторный запуск того же сайта при активном аудите не создает второй аудит и не списывает кредит.

Rate limits

60 запросов в минуту на ключ, запуск аудитов — до 10 в минуту.

Уровни отчетов

Basic

Массовая первичная диагностика и определение уровня AI-готовности сайта.

Full

По договору — для глубокого анализа и полного отчета со всеми рекомендациями.

Допустимый reportLevel определяется условиями договора вашей организации.

Стоимость API

API работает по предоплаченной кредитной модели. 1 кредит = 1 аудит.

100 аудитов

30 000 ₽

300 ₽ за аудит

Получить доступ
Для агентств

500 аудитов

125 000 ₽

250 ₽ за аудит

Получить доступ
Для платформ и больших объемов

2 000 аудитов

400 000 ₽

200 ₽ за аудит

Обсудить подключение

Full API

Индивидуальные условия

Стоимость зависит от объема и уровня отчета. Свяжитесь с нами — подберем условия под ваш сценарий интеграции.

Обсудить Full API

Как устроены кредиты

  • Кредиты оплачиваются заранее — вы всегда знаете бюджет на проверки.
  • Постановка аудита в очередь списывает 1 кредит.
  • При нулевом балансе аудит не запускается — случайный перерасход невозможен.
  • Если аудит завершился внутренней ошибкой AIRA, кредит возвращается автоматически.
  • Остаток кредитов доступен программно — через GET /account.

Начать интеграцию просто

POST /auditsзапустить аудит сайта
GET /audits/{auditId}статус аудита
GET /audits/{auditId}/reportготовый отчет в JSON
GET /accountаккаунт и остаток кредитов
Открыть полную документацию API

Обсудить 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.