POST /aeo-reports/generate — Run an AEO Audit

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

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
  }
}

number

AEO readiness score from 0 to 100. Scores above 70 indicate strong AI-search optimization.

number

Percentage of your pages with valid structured data (schema.org markup).

number

Percentage of your content with clear, AI-citable information (headings, Q&A format, definitions).

number

Count of identified issues that, if fixed, would improve your AEO readiness score.

object

Breakdown of schema validations: valid, incorrect, missing, and other.

object

Plain-language summary with surface findings, deeper root causes, and rootCauses explanation.

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.

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

Status	Code	Meaning
401	`UNAUTHORIZED`	Missing or invalid Bearer token
402	`INSUFFICIENT_CREDITS`	Fewer than 50 credits available
400	`INVALID_URL`	The `url` field is malformed
500	`AUDIT_FAILED`	Report 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.

Get Started

Dashboard

Guides

Credits & Plans

Help

POST /aeo-reports/generate — Run an AEO Audit

Generate an AEO report

Request body

Response

Get the latest report

Export report as PDF

Error responses

​Generate an AEO report

​Request body

​Response

​Get the latest report

​Export report as PDF

​Error responses

Generate an AEO report

Request body

Response

Get the latest report

Export report as PDF

Error responses