API Reference

Visibility Report

Get the AI visibility report for a domain, showing how it appears in AI engine responses to consumer queries.

GET/api/v1/visibility/[slug]

Get the AI visibility report for a domain, showing how it appears in AI engine responses to consumer queries.

Path Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug (e.g., "notion-com")

Query Parameters

Name	Type	Required	Description
`engine`	string	Optional	Filter by engine. Without this param the response is an array. With this param it returns a single object.
`include`	string	Optional	Set to "timeline" to include version history and query deltas.

Example

bash

curl "https:">//www.aeocontent.ai/api/v1/visibility/notion-com" \
  -H "Authorization: Bearer $AEO_API_KEY"

Try it

Response

Returns the visibility report with JSONB section fields at the top level of the data object, alongside metadata fields. Add ?include=timeline for version history.

200Visibility report

json

{
  class="code-string">"data": [
    {
      class="code-string">"slug": class="code-string">"understoodcare-com",
      class="code-string">"domain": class="code-string">"understoodcare.com",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"search_term": class="code-string">"home health care",
      class="code-string">"overall_score": 65,
      class="code-string">"visibility_score": 13,
      class="code-string">"visibility_total": 20,
      class="code-string">"key_findings": [...],
      class="code-string">"llm_response_analysis": [...],
      class="code-string">"query_variants": [...],
      class="code-string">"competitor_comparison": [...],
      class="code-string">"action_plan": [...],
      class="code-string">"topic_phrases": [class="code-string">"cdpap caregiver pay", class="code-string">"medicare denial appeal", ...],
      class="code-string">"created_at": class="code-string">"2026-03-15T10:30:00.000Z"
    }
  ],
  class="code-string">"meta": {
    class="code-string">"request_id": class="code-string">"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    class="code-string">"timestamp": class="code-string">"2026-03-15T12:00:00.000Z"
  }
}

404Not found

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"not_found",
    class="code-string">"message": class="code-string">"No visibility report found for slug 'unknown-com'."
  }
}

Report Sections

Every visibility report contains 5 sections, each focusing on a different aspect of AI visibility.

LLM Response Analysisllm_response_analysis

Ranked sources cited by AI engines, with threat levels and citation reasons

Query Variantsquery_variants

Per-query visibility: which queries the target is visible for, competitor visibility, content needed

Competitive Landscapecompetitor_comparison

How competitors compare in AI visibility across criteria

Action Planaction_plan

Prioritized actions to improve AI visibility (P0-P3)

Key Findingskey_findings

Top warnings and positive findings from the visibility analysis

Visibility reports are generated separately from audits. A domain must have a completed audit before a visibility report is available.

Add ?include=timeline to include version history with score trends and per-query deltas.

Name

Type

Required

Description

slug

string

Required

Domain slug (e.g., "notion-com")

Name

Type

Required

Description

engine

string

Optional

Filter by engine. Without this param the response is an array. With this param it returns a single object.

include

string

Optional

Set to "timeline" to include version history and query deltas.

Example

bash

curl "https:">//www.aeocontent.ai/api/v1/visibility/notion-com" \
  -H "Authorization: Bearer $AEO_API_KEY"

Response

Returns the visibility report with JSONB section fields at the top level of the data object, alongside metadata fields. Add ?include=timeline for version history.

200Visibility report

json

{
  class="code-string">"data": [
    {
      class="code-string">"slug": class="code-string">"understoodcare-com",
      class="code-string">"domain": class="code-string">"understoodcare.com",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"search_term": class="code-string">"home health care",
      class="code-string">"overall_score": 65,
      class="code-string">"visibility_score": 13,
      class="code-string">"visibility_total": 20,
      class="code-string">"key_findings": [...],
      class="code-string">"llm_response_analysis": [...],
      class="code-string">"query_variants": [...],
      class="code-string">"competitor_comparison": [...],
      class="code-string">"action_plan": [...],
      class="code-string">"topic_phrases": [class="code-string">"cdpap caregiver pay", class="code-string">"medicare denial appeal", ...],
      class="code-string">"created_at": class="code-string">"2026-03-15T10:30:00.000Z"
    }
  ],
  class="code-string">"meta": {
    class="code-string">"request_id": class="code-string">"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    class="code-string">"timestamp": class="code-string">"2026-03-15T12:00:00.000Z"
  }
}

404Not found

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"not_found",
    class="code-string">"message": class="code-string">"No visibility report found for slug 'unknown-com'."
  }
}

Report Sections

Every visibility report contains 5 sections, each focusing on a different aspect of AI visibility.

LLM Response Analysisllm_response_analysis

Ranked sources cited by AI engines, with threat levels and citation reasons

Query Variantsquery_variants

Per-query visibility: which queries the target is visible for, competitor visibility, content needed

Competitive Landscapecompetitor_comparison

How competitors compare in AI visibility across criteria

Action Planaction_plan

Prioritized actions to improve AI visibility (P0-P3)

Key Findingskey_findings

Top warnings and positive findings from the visibility analysis