Docs · AEO
Full AEO page audit (premium)
One-call AEO scorecard: runs 9 component probes in parallel and returns one 0–100 score, five category breakdowns, top issues, and ranked recommendations.
POST
/v1/aeo/page-audit The consolidated AEO deliverable. Internally runs meta-audit, readability, snippet-candidates, schema-coverage, citation-readiness, ai-bot-allowlist, llm-fetch-simulator, redirects, and llms-txt-audit in parallel — no extra HTTP work on your side. Returns one headline 0–100 score, five category scores (discoverability, content quality, structured data, answerability, citability), the flat top-issue list, and ranked recommendations weighted by priority. Bills 3 credits (premium orchestration; replaces 9 single calls and runs in roughly the time of the slowest one).
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| url | string | yes | — | Page URL to audit. |
Request
curl -X POST https://api.qcrawl.com/v1/aeo/page-audit \
-H "Authorization: Bearer osk_..." \
-d '{"url": "https://qcrawl.com/architecture/"}'Response
{
"status": "success",
"url": "https://qcrawl.com/architecture/",
"overall_score": 72.4,
"overall_grade": "B",
"category_scores": {
"discoverability": 90.0,
"content_quality": 70.0,
"structured_data": 60.0,
"answerability": 100.0,
"citability": 80.0
},
"top_issues": ["Meta: Title is 75 characters; aim for 30–60.", "Meta: Meta description is 192 characters; aim for 120–160."],
"ranked_recommendations": [
{"priority": "critical", "category": "discoverability", "action": "..."},
{"priority": "high", "category": "structured_data", "action": "Add FAQPage schema..."},
...
],
"components": {
"meta_audit": {...}, "readability": {...}, "schema_coverage": {...},
"citation_readiness": {...}, "ai_bot_allowlist": {...}, "llm_fetch_simulator": {...},
"redirects": {...}, "llms_txt_audit": {...}, "snippet_candidates": {...}
}
}