The Vuni API
Start an audit of any website and read the finished report. Runs go through the same queue and the same models as the app. Reports are also stored on the account and emailed when they finish.
Keys
Sign in, open Settings, and create a key under API. The key is shown once. Send it as a bearer token on every call. Revoke it from the same place.
Credits
One credit is one audit. A plan includes credits each month, spent first. A pack of 10 credits covers the overage and never expires. A run that fails hands its credits back.
| Plan | Included each month |
|---|---|
| Partner | 20 credits |
| Agency | 75 credits |
Products beyond the audit will cost credits in the ratio of their retail price: map 5, icp 5, angles 10, ssot 5, foundation 20, strategy 10, events 10. Only the audit is callable today.
Start an audit
POST https://vuni.ai/api/v1/audits
Authorization: Bearer vn_live_...
Content-Type: application/json
{ "url": "acme.com" }Answers 202 with the run id and the meter after this charge:
{ "id": "6f1c...", "status": "queued", "credits_charged": 1, "paid_from": "plan",
"credits_used": 3, "credits_included": 20, "pack_balance": 0 }Optional pasted: text to read when the site blocks fetching. Refusals name the fix: 401 for a key that is not live, 402 with no active plan, 429 when the month’s credits are used and no pack covers the run.
Read the report
GET https://vuni.ai/api/v1/audits/{id}
Authorization: Bearer vn_live_...Answers status of queued, running, done, or failed. When done, the body carries the full report. Poll every 20 seconds; an audit takes three to twenty minutes.
Limits
Requests are rate limited per address. Runs share the platform queue, so at busy times a run waits before it starts; the id is valid from the moment it is queued.