POST /api/v1/audit — Response

1{
2  "url": "acmecorp.com",
3  "score": 78,
4  "grade": "Good",
5  "scanDuration": 1842,
6  "categories": {
7    "answerReadiness": 82,
8    "structure": 74,
9    "authoritySignals": 71,
10    "technicalGEO": 85
11  },
12  "factors": [
13    {
14      "id": "json_ld_present",
15      "name": "JSON-LD Schema Present",
16      "status": "pass",
17      "score": 20,
18      "max": 20,
19      "details": "Found valid Organization schema with name, url, and description fields."
20    },
21    {
22      "id": "robots_ai_accessible",
23      "name": "AI Crawler Access",
24      "status": "pass",
25      "score": 15,
26      "max": 15,
27      "details": "GPTBot and ClaudeBot are permitted. No AI crawlers blocked."
28    },
29    {
30      "id": "faq_content_present",
31      "name": "FAQ / Q&A Content",
32      "status": "pass",
33      "score": 12,
34      "max": 15,
35      "details": "Found 4 FAQ sections. Recommend adding HowTo schema to procedural pages."
36    },
37    {
38      "id": "author_signals",
39      "name": "Author & E-E-A-T Signals",
40      "status": "warn",
41      "score": 8,
42      "max": 15,
43      "details": "Author bylines found but no structured Person schema. Add author schema to improve authority signals."
44    },
45    {
46      "id": "meta_description",
47      "name": "Meta Description Quality",
48      "status": "fail",
49      "score": 0,
50      "max": 10,
51      "details": "Meta description is missing on 6 pages. AI engines use this to understand page context."
52    }
53  ],
54  "fixes": [
55    {
56      "factorId": 5,
57      "factorName": "Meta Description Quality",
58      "impact": "High",
59      "instruction": "Add meta descriptions to 6 pages missing them"
60    },
61    {
62      "factorId": 4,
63      "factorName": "Author & E-E-A-T Signals",
64      "impact": "Medium",
65      "instruction": "Add Person schema to author profiles"
66    }
67  ],
68  "scannedAt": "2026-03-06T09:14:22Z"
69}