# Introduction à CiteAPI

> Présentation de l'API REST de CiteMe pour intégrer les capacités GEO dans vos applications.

Développeurs v1.0.0

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](./authentication).

### Format des réponses

- Corps de réponse en **JSON** avec un envelope `data` pour 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](./authentication)** | — | Bearer token, scopes, sécurité des clés |
| **[Projets](./projects)** | `GET /projects`, `GET /projects/:id` | Gestion du portfolio de projets |
| **[Audits GEO](./audits)** | `GET /projects/:id/audits`, `POST /projects/:id/audits` | Lancement et récupération des audits |
| **[Suggestions IA](./suggestions)** | `GET /projects/:id/suggestions` | Recommandations d'optimisation |
| **[Mots-clés](./keywords)** | `GET /projects/:id/keywords`, `POST /projects/:id/keywords` | Mots-clés du projet (pas les prompts d'audit) |
| **[Codes d'erreur](./errors)** | — | 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 :

```bash
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](../agents).

**[Authentification →](./authentication)**