Mavera DocsCompany audit
The comprehensive one-shot: real SEO/traffic/competitor data fused with synthetic-audience fieldwork into one scored report.
One call audits a whole company: real SEO, traffic, and competitor data (Semrush) + a market frame + three built audience segments + per-segment awareness/fit/objection fieldwork + a fused scorecard.
curl -N -X POST "$BASE/api/v1/audit" -H "x-api-key: $MAVERA_API_KEY" \
-H "content-type: application/json" -d '{
"company": "Waggle",
"domain": "waggle.com",
"description": "GPS dog collar, $79, no subscription"
}'SSE events: audit.progress {stage, message, fraction} through the five stages, then audit.done {auditId}. Read the full report with GET /api/v1/audit?id=…; list past audits with GET /api/v1/audit. In the app: Audit (sidebar → Advanced).
The five stages
| Stage | What happens | Data class |
|---|---|---|
| Recon | Domain overview (rank, organic traffic/keywords/value), top keywords, organic competitors + their traffic | Real (Semrush) |
| Market | Category frame, one-line positioning read, product matrix vs competitors, 3 segment hypotheses | Model-proposed (labeled) |
| Audiences | Each segment hypothesis becomes a real built synthetic audience | Registry build |
| Fieldwork | Per segment: awareness / fit / appeal scales + open objection question, run_study n=50 | Code-computed stats |
| Synthesis | The scorecard | Code-computed |
The scorecard
- Audience fit / awareness / appeal — 1-5 means straight from the fieldwork aggregates, per segment and averaged
- SEO strength (0-100) — your organic traffic log-scaled against the biggest competitor's (real data, computed in code)
- Competitive pressure (0-100) — the share of your organic competitors that out-traffic you
- Every per-segment row links to its full study (
/s/{id}), and the payload'shonestyblock says exactly which numbers came from where
Cost & time
~350-400 credits, ~10 minutes (three audience builds + three n=50 studies dominate). Partial audits are readable: each stage persists as it completes, so a failed run still shows everything up to the failure.