Developer Documentation
API
Programmatic GEO audits for developers and AI agents.
Overview
Base URL — https://visibleai.space/api/v1
Authentication — None required. Payment via x402.
Payment — $1 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://visibleai.space/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://visibleai.space/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://visibleai.space/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
VisibleAI uses x402 for machine-native payments. No API keys. No accounts. Agents pay $1 USDC on Base per audit.
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