API · AEO Index

Agent Visibility, one call.

The metric for the agent-commerce era — joined on the Shopify domain you already store. Read-only, no pixel, no onboarding.

Endpoint

GET https://aeoindex.io/api/v1/visibility?domain={shop_domain}

Response

{
  "domain": "yourstore.com",
  "vertical": "apparel & accessories",
  "score": { "aeo": 50, "grade": "C", "visibility": 50,
             "covered": 13, "panel_size": 26, "category_percentile_top": 6 },
  "gaps": [ { "query": "base layer", "type": "abstract", "status": "absent",
              "fix": "No product reads as base layer - add it where accurate." } ],
  "competitors": [ { "domain": "fashionnova.com", "appearances": 54, "wins": 11 } ],
  "owned": [ "merino wool top" ]
}

Fields

Field	Meaning
score.aeo	0–100 agent-visibility score
category_percentile_top	Rank vs the category’s merchants (corpus)
gaps[]	Queries the store is invisible for, with the fix
competitors[]	Category leaders from the cross-merchant corpus
owned[]	Queries the store already wins

Integrate

Render it as a native metric tile, or wire it into your AI assistant as a tool — a brand asks “where am I invisible in AI search?” and answers inline. Versioned and stable. For partner keys, rate limits and the compare/gaps endpoints: founder@aeoindex.io.