Introduction — GEOCitation API Docs

Introduction

L'API GEOCitation vous permet de lancer par programmation des audits sémantiques AEO/GEO et de récupérer des données d'intelligence concurrentielle structurées pour vos analyses Market et Gap.

Qu'est-ce que l'API GEOCitation ?

GEOCitation vous donne un accès API-first pour construire votre autorité numérique. Lancez des audits d'Intelligence Marché pour cartographier le paysage concurrentiel, ou des audits d'Analyse de Gaps pour identifier précisément les lacunes de votre contenu. Recevez une notification webhook à la fin de l'audit, et intégrez l'intelligence de citation directement dans vos workflows n8n, agents ou outils internes.

Capacité Clé

Une seule requête POST lance un audit AEO/GEO complet — notre pipeline traite les signaux web à travers un moteur en 9 phases et retourne des données structurées, lisibles par machine.

Asynchrone par Conception

Envoyez une requête et recevez un 202 immédiatement. Soyez notifié via webhook dès que votre audit se termine (généralement 5 à 7 minutes).

Webhooks Signés HMAC

Chaque payload de webhook est signé avec HMAC-SHA256, pour que vous puissiez vérifier qu'il provient bien de GEOCitation.

Exemple Rapide

Lancez un audit d'Intelligence Marché pour un mot-clé en France et récupérez le résultat.

bash

curl -X POST https://api.geocitation.io/v1/audits \
  -H "Content-Type: application/json" \
  -H "X-API-Key: geo_citation_YOUR_KEY" \
  -d '{
    "audit_type": "market",
    "keyword": "agence seo paris",
    "language": "fr",
    "country": "FR"
  }'

json

{
  "audit_id": "3227a3e3-...",
  "status": "pending",
  "created_at": "2026-07-11T14:32:00Z"
}

Concepts Clés