**Endpoint**
- `GET /api/v1/articles` — elenca gli articoli pubblicati; supporta `?page=N` e `?q=search`
- `GET /api/v1/articles/{slug}` — recupera un articolo tramite slug con tutti i metadati di Hearth
- `GET /api/v1/topics` — elenca tutti i cluster di argomenti pubblicati
**Risposte**
Tutte le risposte sono in JSON. I payload degli articoli includono titolo, slug, riassunto, testata, URL della fonte, data di pubblicazione, metadati di Hearth (narrazione, citazione in evidenza, fatti chiave, citazioni chiave, livelli di lettura), punteggio di affidabilità e argomento associato.
**Autenticazione**
Le chiavi API si gestiscono in Admin > Pubblicazione. Non passare mai le chiavi negli URL — usa sempre l'header `X-API-Key`. A tutti gli endpoint pubblici si applicano limiti di frequenza.