Visibility Tools

Search AI visibility reports to understand how your domain appears in AI engine responses.

aeo_search_visibility

Search visibility reports by domain slug or engine. Returns visibility scores, competitor counts, and key findings. Reports are returned in reverse chronological order.

Parameters

Name	Type	Required	Description
`slug`	string	Optional	Domain slug to search for (e.g., "notion-com")
`engine`	string	Optional	Filter by engine (e.g., "chatgpt", "claude")
`limit`	number	Optional	Max results to returnDefault: `20`

Example Usage

json

aeo_search_visibility({ slug: class="code-string">"notion-com" })

Example Response

response

{
  class="code-string">"count": 1,
  class="code-string">"reports": [
    {
      class="code-string">"id": class="code-string">"...",
      class="code-string">"slug": class="code-string">"notion-com",
      class="code-string">"query_slug": class="code-string">"notion-com-chatgpt",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"target_url": class="code-string">"https:class="code-commentclass="code-string">">//notion.com",
      class="code-string">"overall_score": 72,
      class="code-string">"status": class="code-string">"completed",
      class="code-string">"created_at": class="code-string">"2026-02-15T...",
      class="code-string">"latest_version": {
        class="code-string">"version": 1,
        class="code-string">"visibility_score": 72,
        class="code-string">"visibility_total": 100,
        class="code-string">"competitors_found": 5,
        class="code-string">"action_items_count": 8,
        class="code-string">"key_findings": [...]
      }
    }
  ]
}

Report Sections

Each visibility report contains five sections that together paint a full picture of how your domain appears in AI-generated responses.

executive_summary

Overall visibility assessment with headline score and key takeaways.

llm_response_analysis

How AI engines respond to real consumer queries about your category. Shows whether you are cited, paraphrased, or absent.

competitive_landscape

Competitor comparison in AI visibility. Identifies who gets cited more and why.

recommendations

Actionable steps to improve your visibility in AI-generated responses.

methodology

How the test was conducted - which queries were used, which engine version, and scoring criteria.

aeo_get_visibility_timeline

Get the full version history and per-query deltas showing gained and lost visibility over time. Useful for tracking progress after content changes or re-audits.

Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug (e.g., "notion-com")
`query_slug`	string	Optional	Filter to a specific query slug
`engine`	string	Optional	Filter by engine (e.g., "chatgpt", "claude")Default: `"chatgpt"`

Example Usage

json

aeo_get_visibility_timeline({ slug: class="code-string">"notion-com" })

Example Response

response

{
  class="code-string">"report": {
    class="code-string">"id": class="code-string">"...",
    class="code-string">"slug": class="code-string">"notion-com",
    class="code-string">"engine": class="code-string">"chatgpt",
    class="code-string">"overall_score": 72,
    class="code-string">"versions_count": 3
  },
  class="code-string">"timeline": [
    {
      class="code-string">"version": 3,
      class="code-string">"visibility_score": 72,
      class="code-string">"created_at": class="code-string">"2026-03-10T...",
      class="code-string">"delta": +4
    },
    {
      class="code-string">"version": 2,
      class="code-string">"visibility_score": 68,
      class="code-string">"created_at": class="code-string">"2026-02-20T...",
      class="code-string">"delta": -2
    }
  ],
  class="code-string">"query_deltas": [
    {
      class="code-string">"query": class="code-string">"best project management tools",
      class="code-string">"current_score": 8,
      class="code-string">"previous_score": 6,
      class="code-string">"delta": +2,
      class="code-string">"status": class="code-string">"gained"
    },
    {
      class="code-string">"query": class="code-string">"notion vs confluence",
      class="code-string">"current_score": 4,
      class="code-string">"previous_score": 7,
      class="code-string">"delta": -3,
      class="code-string">"status": class="code-string">"lost"
    }
  ],
  class="code-string">"latest_key_findings": [...]
}

Visibility reports test your domain against real consumer queries using AI engines. They complement the technical audit by showing real-world citation behavior.

Visibility Tools

Search AI visibility reports to understand how your domain appears in AI engine responses.

aeo_search_visibility

Search visibility reports by domain slug or engine. Returns visibility scores, competitor counts, and key findings. Reports are returned in reverse chronological order.

Parameters

Name	Type	Required	Description
`slug`	string	Optional	Domain slug to search for (e.g., "notion-com")
`engine`	string	Optional	Filter by engine (e.g., "chatgpt", "claude")
`limit`	number	Optional	Max results to returnDefault: `20`

Example Usage

json

aeo_search_visibility({ slug: class="code-string">"notion-com" })

Example Response

response

{
  class="code-string">"count": 1,
  class="code-string">"reports": [
    {
      class="code-string">"id": class="code-string">"...",
      class="code-string">"slug": class="code-string">"notion-com",
      class="code-string">"query_slug": class="code-string">"notion-com-chatgpt",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"target_url": class="code-string">"https:class="code-commentclass="code-string">">//notion.com",
      class="code-string">"overall_score": 72,
      class="code-string">"status": class="code-string">"completed",
      class="code-string">"created_at": class="code-string">"2026-02-15T...",
      class="code-string">"latest_version": {
        class="code-string">"version": 1,
        class="code-string">"visibility_score": 72,
        class="code-string">"visibility_total": 100,
        class="code-string">"competitors_found": 5,
        class="code-string">"action_items_count": 8,
        class="code-string">"key_findings": [...]
      }
    }
  ]
}

Report Sections

Each visibility report contains five sections that together paint a full picture of how your domain appears in AI-generated responses.

executive_summary

Overall visibility assessment with headline score and key takeaways.

llm_response_analysis

How AI engines respond to real consumer queries about your category. Shows whether you are cited, paraphrased, or absent.

competitive_landscape

Competitor comparison in AI visibility. Identifies who gets cited more and why.

recommendations

Actionable steps to improve your visibility in AI-generated responses.

methodology

How the test was conducted - which queries were used, which engine version, and scoring criteria.

aeo_get_visibility_timeline

Get the full version history and per-query deltas showing gained and lost visibility over time. Useful for tracking progress after content changes or re-audits.

Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug (e.g., "notion-com")
`query_slug`	string	Optional	Filter to a specific query slug
`engine`	string	Optional	Filter by engine (e.g., "chatgpt", "claude")Default: `"chatgpt"`

Example Usage

json

aeo_get_visibility_timeline({ slug: class="code-string">"notion-com" })

Example Response

response

{
  class="code-string">"report": {
    class="code-string">"id": class="code-string">"...",
    class="code-string">"slug": class="code-string">"notion-com",
    class="code-string">"engine": class="code-string">"chatgpt",
    class="code-string">"overall_score": 72,
    class="code-string">"versions_count": 3
  },
  class="code-string">"timeline": [
    {
      class="code-string">"version": 3,
      class="code-string">"visibility_score": 72,
      class="code-string">"created_at": class="code-string">"2026-03-10T...",
      class="code-string">"delta": +4
    },
    {
      class="code-string">"version": 2,
      class="code-string">"visibility_score": 68,
      class="code-string">"created_at": class="code-string">"2026-02-20T...",
      class="code-string">"delta": -2
    }
  ],
  class="code-string">"query_deltas": [
    {
      class="code-string">"query": class="code-string">"best project management tools",
      class="code-string">"current_score": 8,
      class="code-string">"previous_score": 6,
      class="code-string">"delta": +2,
      class="code-string">"status": class="code-string">"gained"
    },
    {
      class="code-string">"query": class="code-string">"notion vs confluence",
      class="code-string">"current_score": 4,
      class="code-string">"previous_score": 7,
      class="code-string">"delta": -3,
      class="code-string">"status": class="code-string">"lost"
    }
  ],
  class="code-string">"latest_key_findings": [...]
}

Visibility reports test your domain against real consumer queries using AI engines. They complement the technical audit by showing real-world citation behavior.