Skip to main content
The AEO Report endpoint runs a full Answer Engine Optimization audit against your brand’s web presence. It analyses structured and unstructured content coverage, validates schema markup (schema.org JSON-LD), counts optimization opportunities, and produces an overall AEO readiness score with a prioritized action plan. You can also export the report as a PDF.
This endpoint costs 50 credits. Credits are validated and deducted before the audit begins. The report takes several minutes to generate.

​
Generate an AEO report

curl -X POST https://api.cognerd.in/aeo-reports/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yoursite.com"}'

const response = await fetch('https://api.cognerd.in/aeo-reports/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ url: 'https://yoursite.com' })
});
const report = await response.json();

​
Request body

​
url
string
The website URL to audit. If omitted, CogNerd uses the URL associated with your active brand profile.

​
Response

{
  "id": "aeo_9c12ab",
  "status": "completed",
  "clientName": "Acme Corp",
  "generationDate": "2024-01-15T12:00:00Z",
  "summary": {
    "structuredCoverage": 62,
    "unstructuredCoverage": 41,
    "optimizationOpportunities": 8,
    "overallAEOReadiness": 54,
    "schemaCounts": {
      "valid": 12,
      "incorrect": 4,
      "missing": 6,
      "other": 2
    },
    "totalSchemas": 24
  },
  "executiveSummary": {
    "surface": "Your brand has partial structured coverage but significant gaps in FAQ and HowTo schema.",
    "deeper": "Unstructured content lacks the citation signals AI platforms rely on when selecting answers.",
    "rootCauses": "Missing Organization and WebSite schema on key landing pages."
  },
  "groups": [...],
  "health": {
    "score": 54,
    "passed": 18,
    "warnings": 5,
    "failed": 7,
    "total": 30
  }
}
​
summary.overallAEOReadiness
number
AEO readiness score from 0 to 100. Scores above 70 indicate strong AI-search optimization.
​
summary.structuredCoverage
number
Percentage of your pages with valid structured data (schema.org markup).
​
summary.unstructuredCoverage
number
Percentage of your content with clear, AI-citable information (headings, Q&A format, definitions).
​
summary.optimizationOpportunities
number
Count of identified issues that, if fixed, would improve your AEO readiness score.
​
summary.schemaCounts
object
Breakdown of schema validations: valid, incorrect, missing, and other.
​
executiveSummary
object
Plain-language summary with surface findings, deeper root causes, and rootCauses explanation.
​
groups
array
Array of diagnostic groups. Each group has a category and an array of checks, where each check includes label, status ("pass", "fail", or "warning"), detail, and an optional fix recommendation.
​
health
object
Aggregate counts: score, passed, warnings, failed, total checks.

​
Get the latest report

Fetch your most recent AEO report without needing the report ID. 
curl https://api.cognerd.in/aeo-reports/latest \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch('https://api.cognerd.in/aeo-reports/latest', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const report = await response.json();

​
Export report as PDF

curl https://api.cognerd.in/aeo-reports/export \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -o aeo-report.pdf

const response = await fetch('https://api.cognerd.in/aeo-reports/export', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const blob = await response.blob();
// Save the PDF blob
The response is a binary PDF (Content-Type: application/pdf) ready for download and sharing with your team.

​
Error responses

StatusCodeMeaning
401UNAUTHORIZEDMissing or invalid Bearer token
402INSUFFICIENT_CREDITSFewer than 50 credits available
400INVALID_URLThe url field is malformed
500AUDIT_FAILEDReport generation failed; retry the request
Run your AEO report before generating GEO files. The report tells you exactly which schemas are missing — fix those gaps first, then regenerate your GEO assets to ensure the new structured data is reflected.