Documentation · Endpoints
Watt Score — Green API
Score indicatif 0–100 pour actifs énergétiques — lecture publique gratuite par id, batch premium jusqu'à 50 items.
GET public (gratuit)
Une référence comparateur Green énergie (`sunexchange`, `energy-web`…) — pas d'authentification.
Usage presse, due diligence rapide, intégration widget.
curl https://getauros.com/api/green/watt/sunexchange
POST batch (clé premium)
Jusqu'à **50 actifs énergétiques** par appel — portfolio solaire, REC, PPA.
`id` = référence comparateur AUROS, ou `text` = description libre (min 10 caractères, mots-clés solar/wind/PPA/REC…).
**Tier premium** : clé `auros_pk_live_*` ou plan Monitor — les clés test gratuites reçoivent 403.
Compte au quota mensuel Protocol — licence volume : /partners.
curl -X POST https://getauros.com/api/v1/green/watt/batch \
-H "Authorization: Bearer auros_pk_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"items":[{"id":"sunexchange"},{"text":"Solar farm 12 MW PPA signed production MWh France"}]}'Réponse batch (extrait)
Le Watt Score est un signal valeur énergétique AUROS — pas un audit de production. Voir aussi /data/green-index et /data/uhi-index.
{
"total": 2,
"succeeded": 2,
"items": [
{
"index": 0,
"ok": true,
"id": "sunexchange",
"watt_score": { "rating": 72, "tier": "mid", "lifetime_gwh": 1.8, "energy_value_eur": 270000 }
}
]
}SDK
Python : `client.green_watt_score("sunexchange")`, `client.green_watt_batch(items=[...])`.
const watt = await client.greenWattScore("sunexchange");
const batch = await client.greenWattBatch({
items: [{ id: "sunexchange" }, { text: "Solar 12 MW PPA production MWh" }],
});