Introduction à CiteAPI
CiteAPI est l'interface de programmation REST de CiteMe. Elle permet aux développeurs d'intégrer les capacités de Generative Engine Optimization directement dans leurs applications, pipelines CI/CD, outils de reporting et workflows marketing.
L'API expose l'ensemble des fonctionnalités de la plateforme CiteMe : gestion des projets, déclenchement et récupération des audits GEO, consultation des suggestions IA, et gestion des mots-clés. Toutes les réponses sont en JSON et l'authentification se fait par Bearer token.
Cas d'usage typiques
Automatisation des audits
Planifiez des audits GEO récurrents via un cron job ou un pipeline CI/CD. Par exemple, déclenchement automatique d'un audit à chaque déploiement de votre site pour mesurer l'impact des modifications de contenu sur votre visibilité IA. Couplez cela avec des alertes Slack ou email pour être notifié si le GEO Score baisse après un déploiement.
Reporting et Business Intelligence
Récupérez les données brutes d'audit (citations, scores, contextes de réponse) pour les intégrer dans vos dashboards de reporting interne. Construisez des rapports personnalisés croisant les données GEO avec vos métriques business (conversion, revenue, trafic) pour mesurer le ROI de votre stratégie GEO.
Intégration dans les outils existants
Connectez CiteMe à votre stack marketing existante. Utilisez l'API pour pousser les suggestions IA directement dans votre CMS, vos outils de gestion de projet, ou vos plateformes de publication (WordPress, Medium, LinkedIn...).
Standards techniques
Conditions d'accès
L'URL de base est https://app.citeme.io/api/v1. L'API est réservée aux forfaits Pro et Expert. L'accès est contrôlé par des scopes portés par la clé : read (lecture) et write (lancer un audit, ajouter un mot-clé). Le scope se choisit à la création de la clé, lecture seule par défaut. Voir Authentification.
Format des réponses
- Corps de réponse en JSON avec un envelope
datapour les résultats - Erreurs sous la forme
{ "error": "message" }avec un code HTTP standard (400, 401, 403, 404, 500)
Endpoints principaux
| Catégorie | Endpoints | Description |
|---|---|---|
| Authentification | — | Bearer token, scopes, sécurité des clés |
| Projets | GET /projects, GET /projects/:id | Gestion du portfolio de projets |
| Audits GEO | GET /projects/:id/audits, POST /projects/:id/audits | Lancement et récupération des audits |
| Suggestions IA | GET /projects/:id/suggestions | Recommandations d'optimisation |
| Mots-clés | GET /projects/:id/keywords, POST /projects/:id/keywords | Mots-clés du projet (pas les prompts d'audit) |
| Codes d'erreur | — | Référence complète de debug |
Démarrage rapide
Générez votre clé secrète depuis le dashboard (Paramètres > Clés API), puis testez avec une première requête :
curl https://app.citeme.io/api/v1/projects \
-H "Authorization: Bearer cm_xxxxxxxxxxxx"
Si la réponse contient vos projets en JSON, votre clé est valide et vous êtes prêt à intégrer CiteAPI dans vos applications.
Vous pilotez CiteMe depuis un agent IA ? Lisez Piloter CiteMe depuis un agent IA.