Documentation

Tout ce qu'il faut pour démarrer avec Citaire

Guide compact et pragmatique. Pas de longs tutoriels — on va à l'essentiel.

Premiers pas

Test gratuit en 30 secondes

Sans inscription : entrez votre marque, votre secteur, votre ville. On vous montre où vous êtes (ou pas) dans ChatGPT, Perplexity et Google AI.

Lancer le test →

Créer un compte

Inscription par email + magic link. Le premier projet est créé en 3 sections : marque, requêtes suivies, concurrents.

S'inscrire →

Comment on mesure

Détail du score, des signaux pondérés et de la fréquence des scans. Transparent et reproductible.

Lire la méthodologie →

Configurer un projet

Créer un nouveau projet

Définir la marque suivie, le secteur, la zone géo. Ajouter 5-20 requêtes représentatives. Importer ses concurrents.

Lancer l'onboarding →

Toutes les fonctionnalités

Liste complète : monitoring, vue concurrents, signaux hors-citation, plan d'action, exports, marque blanche.

Voir la liste →

Changelog

Toutes les nouveautés produit, dans l'ordre chronologique inverse. Mises à jour, correctifs, intégrations.

Voir les versions →

Intégrations & API

API publique v1

REST sous /api/v1, authentification Bearer cit_live_*. Endpoints : projects, scans (GET + POST), actions. Limitez vos clés depuis /compte/api-keys.

Voir l'exemple curl →

Webhooks sortants

À chaque scan terminé, POST signé HMAC-SHA256 vers votre endpoint. Format JSON natif ou Slack/Discord. Configurez par projet depuis /parametres.

Voir la documentation →

Badge embeddable

SVG public sous /embed/[projectId]/badge.svg. Personnalisable en marque blanche (couleur + nom du projet). À coller sur votre site.

Voir un exemple →

Exemple API

Listez vos projets depuis n'importe quel script. Remplacezcit_live_xxxxxpar la clé créée depuis /compte/api-keys.

curl -H "Authorization: Bearer cit_live_xxxxx" \
     https://citaire.fr/api/v1/projects

# Liste les projets
# → { "projects": [ { "id": "...", "name": "...", ... } ] }

Déclencher un scan :

curl -X POST \
     -H "Authorization: Bearer cit_live_xxxxx" \
     https://citaire.fr/api/v1/projects/PROJECT_ID/scans

# → 202 Accepted
# { "scan": { "id": "...", "cited_count": 5, "total_results": 15, ... } }

Webhooks

À chaque scan terminé, Citaire envoie un POST à l'URL que vous avez configurée dans /parametresde votre projet. Format JSON par défaut (signé HMAC-SHA256), ou format Slack/Discord (collez directement une URL d'incoming-webhook).

POST https://votre-endpoint.example.com/webhook
Content-Type: application/json
X-Citaire-Event: scan.completed
X-Citaire-Signature: sha256=<HMAC du body avec votre secret>

{
  "event": "scan.completed",
  "delivered_at": "2026-05-28T10:00:00Z",
  "data": {
    "scan_id": "...", "project_id": "...", "project_name": "Cabinet Durand",
    "total_results": 15, "cited_count": 2, "citation_rate": 0.13
  }
}

Pour Slack/Discord, collez l'URL d'incoming-webhook et choisissez le format Slack/Discord: on envoie le message au bon format, prêt à s'afficher dans votre canal.

Badge embeddable

Affichez votre score de visibilité IA sur votre site avec une image SVG :

<img src="https://citaire.fr/embed/<projectId>/badge.svg"
     alt="Citaire — visibilité IA" />

Personnalisez la couleur et le nom affiché depuis /parametres → Marque blanche du badge.

Une question ? Contactez-nous — on répond en français, sous 24 h ouvrées.