AEO Visibility#

AI engine visibility testing

Run a new visibility test across AI engines#

POST/organizations/{org_id}/aeo/visibility

Test content visibility in AI engines (Gemini, Gemma, etc.). Requires organization membership for the specified organization.

Security#

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer YOUR_API_KEY

Parameters#

Name	Type	Location	Required	Description
`org_id`	string	path	Yes	Organization ID

Request Body#

Example:

{
    "queries": [
        "What is AEO?",
        "How to optimize for AI search?"
    ],
    "url": "https://example.com",
    "content": "string"
}

Code Examples#

curl -X POST "https://searchaf.antfly.io/api/v1/organizations/{org_id}/aeo/visibility" \\
    -H "Authorization: Bearer YOUR_API_KEY" \\
    -H "Content-Type: application/json" \\
    -d '{
    "queries": [
        "What is AEO?",
        "How to optimize for AI search?"
    ],
    "url": "https://example.com",
    "content": "string"
}'

Responses#

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "string",
  "overall_score": 0,
  "queries": [
    {
      "query": "string",
      "found": true,
      "position": 0,
      "relevance_score": 0,
      "snippet": "string"
    }
  ],
  "recommendations": [
    "string"
  ],
  "tested_at": "2025-10-02T15:30:00Z"
}

Get full history of visibility tests#

GET/organizations/{org_id}/aeo/visibility

Retrieve all visibility test results for the specified organization. Requires organization membership.