# GEOCitation Audit API

**Canonical:** https://apis.io/apis/geocitation/geocitation-audit-api/  
**Provider:** GEOCitation — https://apis.io/providers/geocitation/  
**Base URL:** https://api.geocitation.io/v1  
**Documentation:** https://www.geocitation.io/en/documentation

GEOCitation Audit API is published by [GEOCitation](https://apis.io/providers/geocitation/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include SEO, Geo, AEO, AI Search Visibility, and Content Intelligence. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

Asynchronous REST API to launch AEO/GEO audits (Market Intelligence and Gap Analysis), poll status, and retrieve structured JSON output. API-key auth via X-API-Key header; HMAC-SHA256 signed webhooks for audit.completed and audit.failed events.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/audits` | Créer un audit (Market ou Gap) |
| GET | `/v1/audits` | Liste paginée des audits de l'utilisateur |
| GET | `/v1/audits/{audit_id}/stream` | SSE — événements live de l'audit |
| GET | `/v1/audits/{audit_id}/status` | Statut léger (fallback si SSE bloqué) |
| GET | `/v1/audits/{audit_id}/events` | Replay des events d'un audit (hydratation initiale frontend) |
| POST | `/v1/audits/{audit_id}/retry-doc/{doc_slot}` | Relancer le noeud DOC individuel (I-DOC-RETRY) |
| GET | `/v1/audits/{audit_id}` | Statut + output JSON complet (output=null tant que non completed) |
| GET | `/v1/audits/{audit_id}/documents/{doc_type}` | Récupérer un document Markdown (audit status=completed uniquement) |
| GET | `/v1/audits/{audit_id}/manifest` | Récupérer le manifest.json SOC2 bank-proof (audit status=completed uniquement) |
| GET | `/v1/usage` | État du quota d'audits de l'utilisateur (plan, used, limit, remaining) |
| GET | `/v1/meta/kpi-catalog` | Catalogue complet des KPIs (35 N20 + 15 pépites) |
| GET | `/v1/meta/icp-priority/{icp_key}` | Priorité KPIs pour un ICP |
| GET | `/v1/meta/branding` | Labels métier FR/EN pour les 50 KPIs |
| POST | `/v1/opt-out` | Ajouter un domaine à la liste opt-out GDPR (admin only) |
| GET | `/v1/opt-out` | Liste des domaines opt-out (admin only) |
| GET | `/health` | Health |
| GET | `/health/detailed` | Health Detailed |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/geocitation/refs/heads/main/openapi/geocitation-openapi.json
- **APIReference** — https://api.geocitation.io/docs
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/geocitation/refs/heads/main/apis.yml

## Tags

SEO, Geo, AEO, AI Search Visibility, Content Intelligence, Competitive Intelligence, Marketing, MarTech, White Label, Agency Tooling, Web Data & Analytics

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/geocitation/geocitation-audit-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/geocitation/.