API & Agent Integration

curl "https://xanlens.com/api/v1/audit/status?jobId=abc-123"

// Returns: Complete audit report with scores, engines breakdown,
// blind spots, citations, competitor analysis, and recommendations

curl -X POST "https://xanlens.com/api/v1/audit/share-verify" \
  -H "Content-Type: application/json" \
  -d '{"jobId": "abc-123", "tweetUrl": "https://x.com/user/status/123"}'

// Returns: Verification status and discount code for next audit

curl "https://xanlens.com/api/v1/audit/fixes?jobId=abc-123"

// Returns: Generated GEO content including blog posts, FAQ schema,
// JSON-LD markup, llms.txt, and seed citations for improvement

curl -X POST https://xanlens.com/api/v1/audit/detect \
  -H "Content-Type: application/json" \
  -d '{"website": "stripe.com"}'

// Returns: Detected brand name, industry, and competitor list
// for use in audit requests

import requests, time

BASE = "https://xanlens.com/api/v1"

# Step 1: Detect brand (required — ~50s)
detected = requests.post(f"{BASE}/audit/detect", json={"website": "acme.com"}).json()

# Step 2: Submit audit with all detect fields + coupon
audit = requests.post(f"{BASE}/audit", json={**detected, "coupon": "GEO-XXXX-XXXX"}).json()
job_id = audit["job_id"]

# Step 3: Execute (fires all prompts server-side)
requests.post(f"{BASE}/audit/execute", json={"jobId": job_id})

# Step 4: Poll for results
while True:
    result = requests.get(f"{BASE}/audit/status?jobId={job_id}").json()
    if result["status"] == "complete":
        break
    print(f"Progress: {result['done']}/{result['total']}")
    time.sleep(15)

print(f"GEO Score: {result['overall_score']}/100 ({result['grade']})")

const BASE = "https://xanlens.com/api/v1";
const delay = ms => new Promise(r => setTimeout(r, ms));

// Step 1: Detect
const detected = await fetch(`${BASE}/audit/detect`, {
  method: "POST", headers: {"Content-Type": "application/json"},
  body: JSON.stringify({website: "acme.com"})
}).then(r => r.json());

// Step 2: Submit with all detect fields
const audit = await fetch(`${BASE}/audit`, {
  method: "POST", headers: {"Content-Type": "application/json"},
  body: JSON.stringify({...detected, coupon: "GEO-XXXX-XXXX"})
}).then(r => r.json());

// Step 3: Execute
await fetch(`${BASE}/audit/execute`, {
  method: "POST", headers: {"Content-Type": "application/json"},
  body: JSON.stringify({jobId: audit.job_id})
});

// Step 4: Poll
let result;
do {
  await delay(15000);
  result = await fetch(`${BASE}/audit/status?jobId=${audit.job_id}`).then(r => r.json());
} while (result.status !== "complete");

console.log(`GEO Score: ${result.overall_score}/100 (${result.grade})`);