GeoXylia API Documentation

Run GEO/SEO audits programmatically, generate white-label reports, and monitor your AI citability — all through a simple REST API.

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key from the GeoXylia Dashboard.

Keys start with gx_ and are tiered by your subscription plan.

curl -H "Authorization: Bearer gx_abc123_..." https://api.geoxylia.com/api/audit \
  -d '{"url":"https://example.com"}'

Rate Limits

Each API key has a daily quota and a monthly limit based on the tier:

Daily quotas reset on a rolling 24-hour window. Monthly limits reset on the key's creation date each month. When exceeded, the API returns 401 with reason daily_limit_exceeded or monthly_limit_exceeded.

Endpoints

POST /api/audit

Run a full 9-dimension GEO/SEO audit on any URL.

curl -X POST https://www.geoxylia.com/api/audit \
  -H "Authorization: Bearer gx_abc123_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Response includes overall score, grade, per-dimension scores, findings, and AI recommendations.

POST /api/mcp

MCP-compatible endpoint for AI assistants. Supports tool discovery and execution.

# List available tools
curl -X POST https://www.geoxylia.com/api/mcp \
  -H "Authorization: Bearer gx_abc123_..." \
  -d '{"method": "tools/list"}'

# Run an audit via MCP
curl -X POST https://www.geoxylia.com/api/mcp \
  -H "Authorization: Bearer gx_abc123_..." \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "geoxylia_audit",
      "arguments": {"url": "https://example.com"}
    }
  }'

White-Label Reports

Generate branded PDF and PPTX reports for your clients. All report endpoints accept an optional whiteLabel object in the request body:

{
  "whiteLabel": {
    "companyName": "Your Agency",
    "logoUrl": "https://your-site.com/logo.png",
    "brandColor": "#FF6600",
    "clientName": "Acme Corp",
    "removeBranding": false
  }
}

POST /api/audit/[id]/report

Generate a branded white-label PDF report for a completed audit. Uses generateWhiteLabelReport() to produce structured data, rendered as a polished PDF.

curl -X POST https://www.geoxylia.com/api/audit/<audit-id>/report \
  -H "Authorization: Bearer gx_abc123_..." \
  -H "Content-Type: application/json" \
  -d '{
    "whiteLabel": {
      "companyName": "Your Agency",
      "brandColor": "#FF6600",
      "clientName": "Acme Corp"
    }
  }' \
  --output report.pdf

POST /api/audit/[id]/pdf

Download a PDF of the full audit report. Optional white-label branding via query params.

POST /api/audit/[id]/pptx

Download a PowerPoint (.pptx) presentation of the audit. Honors whiteLabel.brandColor and whiteLabel.companyName for the title slide.

POST /api/audit/[id]/executive-pdf

Download an executive-summary PDF with top findings and recommendations. Supports full white-label customization including logoUrl and removeBranding.

Client-Branded Fallback

If an audit was created for a Clientrecord in the agency dashboard, the PDF/PPTX endpoints automatically use the client's stored logoUrl and brandColor. Explicitly passing whiteLabel in the request body overrides these defaults.

Error Codes

Getting Help

Questions? Open an issue on GitHub or email api@geoxylia.com.

GeoXylia v2 · Updated July 2026