Introduction a CiteAPI
CiteAPI est l'interface de programmation REST de CiteMe. Elle permet aux developpeurs d'integrer les capacites de Generative Engine Optimization directement dans leurs applications, pipelines CI/CD, outils de reporting et workflows marketing.
L'API expose l'ensemble des fonctionnalites de la plateforme CiteMe : gestion des projets, declenchement et recuperation des audits GEO, consultation des suggestions IA, et gestion des mots-cles. Toutes les reponses sont en JSON, l'authentification se fait par Bearer token, et les scopes de permission sont determines par votre forfait.
Cas d'usage typiques
Automatisation des audits
Planifiez des audits GEO recurrents via un cron job ou un pipeline CI/CD. Par exemple, declenchement automatique d'un audit a chaque deploiement de votre site pour mesurer l'impact des modifications de contenu sur votre visibilite IA. Couplez cela avec des alertes Slack ou email pour etre notifie si le GEO Score baisse apres un deploiement.
Reporting et Business Intelligence
Recuperez les donnees brutes d'audit (citations, scores, contextes de reponse) pour les integrer dans vos dashboards de reporting interne. Construisez des rapports personnalises croisant les donnees GEO avec vos metriques business (conversion, revenue, trafic) pour mesurer le ROI de votre strategie GEO.
Integration dans les outils existants
Connectez CiteMe a 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'acces
L'API est reservee aux abonnes Pro et Expert. Les cles API sont chiffrees au repos avec AES-256-GCM et l'acces est controle par des scopes de permission (lecture seule pour le plan Pro, lecture et ecriture pour le plan Expert).
Format des reponses
Toutes les reponses suivent les standards RESTful :
- Corps de reponse en JSON avec un envelope
datapour les resultats - Codes de statut HTTP standards (200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Error)
- Headers
Content-Type: application/jsonetX-RateLimit-Remainingsur chaque reponse
Rate limiting
| Plan | Requetes par minute | Requetes par jour |
|---|---|---|
| Pro | 30 | 5 000 |
| Expert | 120 | 50 000 |
Les headers de reponse incluent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset pour vous permettre de gerer le rate limiting dans votre code.
Endpoints principaux
| Categorie | Endpoints | Description |
|---|---|---|
| Authentification | — | Bearer token, scopes, securite des cles |
| Projets | GET /projects, GET /projects/:id | Gestion du portfolio de projets |
| Audits GEO | GET /projects/:id/audits, POST /projects/:id/audits | Lancement et recuperation des audits |
| Suggestions IA | GET /projects/:id/suggestions | Recommandations d'optimisation |
| Mots-cles | GET /projects/:id/keywords, POST /projects/:id/keywords | Gestion des prompts de recherche |
| Codes d'erreur | — | Reference complete de debug |
Demarrage rapide
Generez votre cle secrete depuis le dashboard (Parametres > Cles API), puis testez avec une premiere requete :
curl https://citeme.ai/api/v1/projects \
-H "Authorization: Bearer cm_live_xxxxxxxxxxxx"
Si la reponse contient vos projets en JSON, votre cle est valide et vous etes pret a integrer CiteAPI dans vos applications.