Для разработчиков

REST API Робот Вак

Встраивайте ИИ-аудит вакансий в свою ATS, HR-платформу или скрипты. Передайте текст вакансии (или файл / ссылку HH.ru) — получите структурированный JSON с оценками по 5 критериям. Каждый аудит списывает 1 кредит с баланса аккаунта.

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

Зарегистрируйтесь и нажмите «Получить API-ключ» ниже. Ключ привязан к балансу кредитов вашего аккаунта.

POST /api/v1/vacancy/audit

Отправьте текст вакансии (поле text), файл (PDF / DOCX) или ссылку HH.ru. Ответ — синхронный JSON.

Получите результат

В ответе — оценки по 5 критериям, суммарный балл из 10, рекомендации и публичная ссылка «Было/Стало».

Параметры запроса (multipart/form-data)

text Текст вакансии (строка, ≥50 символов)

url Ссылка на вакансию HH.ru

file Файл PDF / DOCX / TXT (до 10 МБ)

Укажите одно из трёх: text, url или file.

Коды ответа

200 Аудит выполнен, JSON с результатами

400 Нет текста / файл слишком мал / неверный формат

402 insufficient_credits — недостаточно кредитов

429 Лимит гостевых аудитов с одного IP исчерпан

Зарегистрироваться и получить ключ →

curl — отправить текст вакансии

curl -X POST https://robotvak.ru/api/v1/vacancy/audit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text=Менеджер по продажам. Оклад 80 000 ₽..."

curl — ссылка HH.ru

curl -X POST https://robotvak.ru/api/v1/vacancy/audit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "url=https://hh.ru/vacancy/12345678"

Ответ 200 OK

{
  "id": 42,
  "title": "Менеджер по продажам",
  "audit_status": "done",
  "audit_total_score": 7,
  "public_share_token": "abc123xyz",
  "audit": {
    "total_score": 7,
    "evaluation": [
      {
        "criterion": "Оффер",
        "score": 2,
        "comment": "Размытый оффер, нет вилки"
      },
      // ... ещё 4 критерия: Результат, Фильтры, CTA, Смыслы
    ],
    "recommendations": ["Добавьте конкретную вилку зарплаты", "..."]
  }
}

Python

import requests

resp = requests.post(
    "https://robotvak.ru/api/v1/vacancy/audit",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    data={"text": vacancy_text},
)
result = resp.json()
print(result["audit_total_score"],
      result["audit"]["recommendations"])