Run AI-visibility audits programmatically and pipe results into your own stack. Create an API key →
Authorization: Bearer gm_live_xxxxxxxx
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/score/{domain} | Instant GEO score (no credit used) |
| POST | /api/v1/audits | Run a full audit — body {"url":"site.com"} (uses a credit) |
| GET | /api/v1/audits/{id} | Audit status + full report JSON |
| GET | /api/v1/audits | List your recent audits |
| POST | /api/v1/webhooks | Register a webhook — body {"url":"https://…"} |
| GET / DELETE | /api/v1/webhooks[/{id}] | List / remove webhooks |
curl https://www.geo-maxed.com/api/v1/score/example.com \ -H "Authorization: Bearer gm_live_xxxxxxxx"
When a full audit completes we POST { event:"audit.completed", data:{ id, domain, unified_score, grade, result_url, api_url } } to your URL. Verify the X-GeoMaxed-Signature header: it's the hex HMAC-SHA256 of the raw request body using your webhook secret.
GeoMaxed is a remote MCP server — add it to Claude and just ask it to run audits.
https://www.geo-maxed.com/mcp → log in to GeoMaxed when prompted.claude mcp add --transport http geomaxed https://www.geo-maxed.com/mcp (opens a browser to authorize).Tools exposed: geo_score, run_audit, get_audit, list_audits. Authorization uses a one-time login — no key copy-paste.
Machine-readable spec at https://www.geo-maxed.com/openapi.json.
https://www.geo-maxed.com/openapi.json → set auth to API Key (Bearer).