API

API développeurs

Interrogez les data centers — opérateurs, statut, position — et leurs notes d'acceptabilité indépendantes, via une API REST simple.

RESTJSONLecture seuleAPI stable 1 414 data centers · 18 pays indexés

ScoreMyDataCenter ouvre la vérité et vend la commodité : les notes sont gratuites à lire sur le site ; l'API vend l'accès machine — structuré, à jour, requêtable — et la synthèse, jamais le fait brut. La liste est ouverte, la profondeur est derrière la clé.

URL de base https://api.scoremydatacenter.org

Démarrer en 10 secondes

Deux endpoints, en lecture seule

GET /v1/datacenters Gratuit · sans clé

Lister les data centers

Identité, note-lettre A–E, statut, position approximative. Filtrable par pays, paginé.

Requête

curl "https://api.scoremydatacenter.org/v1/datacenters?country=FR&limit=10"

import requests

r = requests.get(
    "https://api.scoremydatacenter.org/v1/datacenters",
    params={"country": "FR", "limit": 10},
)
print(r.json()["pagination"]["total"])  # 257

Réponse

200 · application/json

{
  "pagination": { "page": 1, "limit": 10, "total": 257 },
  "data": [
    {
      "id": "fr-databank-fr3-gdc3",
      "name": "DataBank FR3 / GDC3",
      "operator": "DataBank",
      "municipality": "Vélizy-Villacoublay",
      "country": "FR",
      "project_status": "operational",
      "grade": "C",
      "coordinates": { "lat": 48.78, "lon": 2.20 },
      "power_rank": 1
    }
  ]
}

Corpus total 1 414. limit plafonné à 10.

GET /v1/datacenters/{id} Payant · clé requise

Détail d'une fiche

La fiche scorée complète — les 5 piliers notés, les indicateurs sourcés et la synthèse d'analyste. Exemple de réponse :

Requête

curl -H "X-API-Key: <votre_clé>" \
  "https://api.scoremydatacenter.org/v1/datacenters/fr-databank-fr3-gdc3"

import requests

r = requests.get(
    "https://api.scoremydatacenter.org/v1/datacenters/fr-databank-fr3-gdc3",
    headers={"X-API-Key": "<votre_clé>"},
)
fiche = r.json()

Réponse

200 · application/json

{
  "id": "fr-databank-fr3-gdc3",
  "name": "DataBank FR3 / GDC3",
  "operator": "DataBank",
  "country": "FR",
  "grades": {
    "site":            { "grade": "C", "score": 58 },
    "project_process": { "grade": "B", "score": 71 }
  },
  "confidence": { "level": "medium" },
  "pillars": {
    "energy":                  { "grade": "C", "score": 55 },
    "water":                   { "grade": "B", "score": 68 },
    "land_biodiversity":       { "grade": "C", "score": 60 },
    "local_impact":            { "grade": "D", "score": 42 },
    "transparency_governance": { "grade": "B", "score": 70 }
  },
  "indicators": [
    { "id": "E1", "value": "PUE 1.28", "source": "https://…" }
  ],
  "synthesis": { "fr": "…", "en": "…" }
}

Réponse 200 · Cache-Control: private, no-store.

Gratuit vs API Pro

	Gratuit	API Pro
Identité (nom, opérateur, pays)	✓	✓
Statut du projet	✓	✓
Note-lettre A–E	✓	✓
Position approximative (~1 km)	✓	✓
Score détaillé /100	—	✓
5 piliers notés	—	✓
Indicateurs sourcés	—	✓
Synthèse	—	✓

Tarifs

Découverte

0 €

Testez la liste et les résumés, sans clé, gratuitement.

Data DC

2 000 €/an

Jusqu'à 30 fiches/jour · 300/an

Accès complet aux fiches : notes détaillées, 5 piliers, indicateurs sourcés, synthèse.

Demander un accès

Gros volume

sur contact

Au-delà de 30/jour ou 300/an, ou pour intégrer la donnée à grande échelle ? Écrivez-nous.

Nous écrire

Cas d'usage Reporting ESGChoix de siteRecherche académiqueIntelligence de marchéJournalisme

Récupérer votre clé

Après paiement, revenez ici et récupérez votre clé en un clic — aucun email à attendre.

J'ai payé, révéler ma clé →

Authentification

La clé passe dans l'en-tête X-API-Key, uniquement. Une clé en paramètre d'URL (?api_key=) n'authentifie pas et renvoie 401 — pour ne jamais laisser fuir une clé dans les logs.

Codes d'erreur

Code	Type	Quand
400	`bad_id`	id malformé
401	`missing_key`	en-tête X-API-Key absent
403	`invalid_key`	clé inconnue ou révoquée
404	`not_found`	fiche inexistante
405	`method_not_allowed`	verbe autre que GET
429	`quota_exceeded`	quota journalier/annuel dépassé