For Developers & AI Agents

API & Agent Integration

GEO audits for your apps, tools, and AI agents. REST API + MCP server.

Overview

Base URL — https://xanlens.xyz/api/v1

Authentication — None required. Payment via x402.

Payment — $0.99 USDC per request (Base network)

Format — JSON in, JSON out

POST/audit

Run a visibility audit for a brand across AI search engines.

Request

curl -X POST https://xanlens.xyz/api/v1/audit \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402" \
  -d '{
    "brand": "Acme Corp",
    "industry": "SaaS",
    "competitors": ["Competitor A", "Competitor B"],
    "engines": ["chatgpt", "perplexity", "gemini"]
  }'

Response

{
  "brand": "Acme Corp",
  "overall_score": 72.5,
  "grade": "B",
  "engines": {
    "chatgpt": {
      "score": 85,
      "mentions": 4,
      "sentiment": "positive"
    },
    "perplexity": {
      "score": 68,
      "mentions": 2,
      "sentiment": "neutral"
    },
    "gemini": {
      "score": 64,
      "mentions": 2,
      "sentiment": "positive"
    }
  },
  "categories": {
    "discovery": {
      "score": 45,
      "detail": "Brand appears in 2/5 discovery queries"
    },
    "branded": {
      "score": 92,
      "detail": "Strong branded presence"
    },
    "comparison": {
      "score": 78,
      "detail": "Mentioned favorably vs competitors"
    }
  },
  "recommendations": [
    "Publish authoritative guides for discovery queries",
    "Add structured data to improve AI parsing",
    "Create comparison content targeting competitor queries"
  ]
}

Parameters

Field	Type	Required	Description
`brand`	string	Yes	Brand or company name
`industry`	string	Yes	Industry or vertical
`competitors`	string[]	No	Up to 5 competitor names
`engines`	string[]	No	AI engines to check (default: all)

Examples

Python

import requests

response = requests.post(
    "https://xanlens.xyz/api/v1/audit",
    json={"brand": "Acme Corp", "industry": "SaaS"},
    headers={"X-Payment": "x402"}
)

audit = response.json()
print(f"Score: {audit['overall_score']}/100 ({audit['grade']})")

JavaScript

const res = await fetch("https://xanlens.xyz/api/v1/audit", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-Payment": "x402" },
  body: JSON.stringify({ brand: "Acme Corp", industry: "SaaS" })
});

const audit = await res.json();
console.log(`Score: ${audit.overall_score}/100 (${audit.grade})`);

x402 Payment Protocol

XanLens uses x402 for machine-native payments. No API keys. No accounts. Free audits. $0.99 USDC on Base per fix.

Flow:

1. Send request with X-Payment: x402 header

2. Server returns 402 with payment details

3. Agent sends USDC on Base network

4. Retry with transaction hash — server verifies and returns data

MCP Server (AI Agents)

For AI agents using Model Context Protocol, XanLens is available as a native tool. Your agent can call GEO audits without leaving its workflow.

Install:

openclaw skills install xanlens-audit

Compatible with OpenClaw, Claude Desktop, Cursor, and any MCP-compatible framework. The agent gets a xanlens_audit tool that accepts brand, website, and industry parameters.

Ready to integrate?

Start making audit requests in minutes.

Try Free Audit First