# Projets

> Endpoints API pour la gestion des projets CiteMe.

# Gestion des Projets

Les projets sont l'unité organisationnelle centrale dans CiteMe, regroupant domaines, mots-clés suivis et historique du GEO Score.

---

## `GET /projects`

Récupère tous les projets associés à votre organisation.

**Réponse (200 OK) :**

```json
{
  "data": [
    {
      "id": "proj_12345",
      "name": "CiteMe AI",
      "url": "https://exemple.com",
      "status": "READY",
      "created_at": "2026-01-08T22:33:23Z"
    }
  ]
}
```

:::tip
Cet endpoint est essentiel pour obtenir les **IDs de projets** nécessaires aux appels API suivants.
:::

---

## `GET /projects/:id`

Accédez aux métadonnées techniques et au dernier snapshot GEO d'un projet spécifique.

**Réponse (200 OK) :**

```json
{
  "data": {
    "id": "proj_12345",
    "name": "CiteMe AI",
    "url": "https://exemple.com",
    "status": "READY",
    "project_snapshots": {
      "last_checked_at": "2026-01-23T10:00:00Z",
      "pages": 42,
      "structured_data_score": 85,
      "meta_quality_score": 92
    }
  }
}
```

| Champ | Description |
|-------|-------------|
| `pages` | Nombre de pages analysées |
| `structured_data_score` | Score de qualité des données structurées |
| `meta_quality_score` | Score de qualité des métadonnées |
| `last_checked_at` | Dernière vérification automatisée |

---

**[Audits GEO →](./audits)**
