Audits GEO

Les endpoints d'audit permettent de récupérer l'historique et de déclencher de nouveaux audits sur vos projets.

---

GET /projects/:id/audits

Récupère l'historique complet des audits pour un projet.

Réponse (200 OK) :

{
  "data": [
    {
      "id": "audit_9876",
      "score": 78,
      "status": "COMPLETED",
      "duration": 4500,
      "created_at": "2026-01-22T15:30:00Z",
      "technical_details": {
        "model": "gpt-5.2",
        "region": "fr"
      }
    }
  ]
}

---

POST /projects/:id/audits

Déclenche un nouvel audit GEO.

Accès restreint

Le déclenchement manuel via API est limité au plan EXPERT. Chaque audit consomme des crédits de quota mensuel.

Corps de la requête :

{
  "keywords": ["best seo saas", "AI optimization"],
  "model": "gpt-4.1",
  "region": "en"
}

Réponse (201 Created) :

{
  "data": {
    "auditId": "audit_abc123",
    "jobId": "job_xyz789"
  }
}

Champ	Description
keywords	Liste des mots-clés à auditer
model	Modèle IA cible
region	Langue/région pour la simulation
auditId	Identifiant unique de l'audit créé
jobId	Identifiant du job pour le suivi asynchrone

---

Suggestions IA →