# API et CLI: Vos données GEO, dans votre propre code.

> CiteAPI, l’API REST sur les données de la plateforme Citeme : récupérez les audits d’un projet dans votre reporting et exportez vos rapports à tout moment.

[Version HTML](https://www.citeme.io/fr/features/api)

---

CiteAPI est une API REST sur les mêmes données que la plateforme. Récupérez tous les audits d’un projet dans votre propre reporting, construisez un tableau de bord, un script ou une fonctionnalité produit, et gardez vos clés chiffrées et révocables.

## Chiffres clés

- **10** moteurs IA derrière les données
- **AES-256** clés chiffrées en GCM
- **4** derniers caractères affichés
- **1** citeme login pour la CLI et MCP

## Qu’est-ce que CiteAPI ?

CiteAPI est l’API REST de Citeme. Vous écrivez du code pour l’appeler, vous gérez vous-même l’authentification, la pagination et les formats, et vous obtenez exactement ce que vous avez demandé. Elle sert les mêmes données que le serveur MCP à un consommateur différent : votre code plutôt qu’un modèle. Utilisez-la quand vous construisez quelque chose : un tableau de bord, un script, une fonctionnalité produit.

## Mêmes données, votre propre code.

### Tous les audits, un seul GET

Un GET sur les audits d’un projet renvoie la liste complète : c’est ainsi que vous récupérez les scores dans votre propre reporting.

### Des audits complets

Chaque audit arrive avec son score, son statut, sa durée en millisecondes, son horodatage de création et ses détails techniques, dont le modèle qui a répondu et la région simulée.

### Webhooks entrants

Un déclencheur webhook entrant génère une URL que n’importe quel système externe peut appeler. Le corps de la requête devient la charge utile du déclencheur, réutilisable par chaque nœud en aval.

### Une connexion, CLI et MCP

Le serveur MCP lit les mêmes identifiants que la CLI Citeme : en configuration locale de Claude Desktop ou sur Claude Code, un seul citeme login couvre les deux.

### Rapports exportables

Les rapports exportables sont inclus dans l’offre, avec un modèle de rapport PDF prêt à l’emploi. Rien n’est supprimé si vous résiliez.

### Clés chiffrées et révocables

Les clés sont chiffrées en AES-256-GCM, seuls leurs quatre derniers caractères sont affichés, et la révocation est immédiate. Les clés cm_live_ ayant fuité sur un GitHub public sont révoquées d’office.

## Récupérez, connectez-vous, déclenchez, exportez.

### Les audits dans votre reporting

Un GET sur les audits d’un projet renvoie la liste complète : score, statut, durée en millisecondes, horodatage de création et détails techniques. Comme le score affiché lisse plusieurs exécutions, lisez la série plutôt qu’un seul point.

### Une connexion pour la CLI et MCP

ChatGPT, Cursor et n8n accèdent au serveur MCP avec une clé CLI Citeme issue de votre compte. En configuration locale de Claude Desktop ou sur Claude Code, le serveur lit les identifiants de la CLI : un seul citeme login couvre les deux.

### Déclenchez Nova de l’extérieur

Le déclencheur webhook entrant génère une URL que n’importe quel système externe peut appeler. Le corps de la requête devient la charge utile du déclencheur : votre propre stack peut confier une tâche à Nova.

### Exportez vos rapports

Les rapports exportables sont inclus dans l’offre, avec un modèle de rapport PDF prêt à l’emploi. Si vous résiliez, le compte passe en lecture seule à la fin de la période payée : rien n’est supprimé, exportez quand vous le souhaitez.

## Trois étapes. Aucun chantier de mise en place.

1. **Connectez-vous une fois** Lancez citeme login, ou utilisez une clé CLI Citeme issue de votre compte pour les clients MCP.
2. **Récupérez vos audits** Un GET sur les audits d’un projet renvoie la liste complète.
3. **Utilisez vos propres outils** Mettez les scores en graphique dans votre reporting, ou exportez des rapports depuis Citeme.

## Questions fréquentes

### Dois-je utiliser l’API ou le serveur MCP ?

Mêmes données, consommateur différent. Si vous intégrez Citeme dans un logiciel, utilisez l’API : vous écrivez les requêtes et gérez l’authentification, la pagination et les formats. Si vous voulez interroger votre GEO dans l’assistant que vous avez déjà ouvert, utilisez le serveur MCP : il décrit ses propres outils et vous n’écrivez jamais de requête.

### Puis-je récupérer les scores d’audit dans mon propre reporting ?

Oui. Un GET sur les audits d’un projet renvoie la liste complète, chaque audit étant stocké avec son score, son statut, sa durée en millisecondes, son horodatage de création et ses détails techniques, dont le modèle qui a répondu et la région simulée. Comme le score affiché combine l’exécution en cours avec les précédentes, une vraie amélioration apparaît sur deux ou trois audits.

### Puis-je déclencher un nouvel audit via l’API ?

Le déclenchement d’un nouvel audit via l’API est restreint, et chaque audit lancé consomme des crédits de votre quota mensuel. Récupérer les audits dont un projet dispose déjà est la façon d’alimenter votre propre reporting.

### Quel lien entre la CLI Citeme et le serveur MCP ?

ChatGPT, Cursor, n8n et les autres clients MCP s’authentifient auprès du serveur MCP distant avec une clé CLI Citeme issue de votre compte. Pour la configuration locale de Claude Desktop, ou pour Claude Code, le serveur lit les mêmes identifiants que la CLI Citeme : un seul citeme login couvre les deux. Dans Claude lui-même, le connecteur OAuth ne demande aucune clé.

### Comment les clés sont-elles protégées ?

Les clés sont chiffrées au repos en AES-256-GCM, les clés de chiffrement étant dans un KMS séparé, et le tableau de bord n’affiche que les quatre derniers caractères. La révocation depuis les paramètres est immédiate. Citeme analyse en continu les dépôts GitHub publics et révoque toute clé ayant fuité dans son propre format cm_live_, en prévenant le propriétaire par e-mail. Un Editor peut lancer des audits qui utilisent les clés, mais ne peut jamais les voir, les modifier ni les exporter.

### Puis-je exporter mes rapports ?

Oui. Les rapports exportables sont inclus dans l’offre, avec un modèle de rapport PDF prêt à l’emploi. Si vous résiliez, votre compte reste disponible jusqu’à la fin de la période payée, puis passe en lecture seule. Rien n’est supprimé : vous pouvez exporter vos rapports et contenus quand vous le souhaitez.

## Pages liées

- [Serveur MCP](https://www.citeme.io/fr/features/mcp): Vos données dans ChatGPT, Claude et Cursor
- [Intégrations](https://www.citeme.io/fr/features/integrations): Déployez les correctifs via votre stack
- [Nova, agent IA](https://www.citeme.io/fr/features/ai-agents): Trouve l’écart, rédige le correctif
- [Audit GEO](https://www.citeme.io/fr/features/geo-audit): Ce que l’IA dit de vous
