API

Developer API

Query European data centers — operators, status, location — and their independent acceptability grades, through a simple REST API.

RESTJSONRead-onlyStable API 1,414 data centers · 18 countries indexed

ScoreMyDataCenter opens the truth and sells the convenience: grades are free to read on the site; the API sells machine access — structured, fresh, queryable — and synthesis, never the raw fact. The list is open, the depth is behind the key.

Base URL https://api.scoremydatacenter.org

Start in 10 seconds

Two endpoints, read-only

GET /v1/datacenters Free · no key

List data centers

Identity, A–E letter grade, status, approximate location. Filterable by country, paginated.

Request

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

Response

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
    }
  ]
}

Total corpus 1,414. limit capped at 10.

GET /v1/datacenters/{id} Paid · key required

Fiche detail

The full scored fiche — the 5 scored pillars, sourced indicators and the analyst synthesis. Example response:

Request

curl -H "X-API-Key: <your_key>" \
  "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": "<your_key>"},
)
fiche = r.json()

Response

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": "…" }
}

Returns 200 · Cache-Control: private, no-store.

Free vs API Pro

	Free	API Pro
Identity (name, operator, country)	✓	✓
Project status	✓	✓
Letter grade A–E	✓	✓
Approximate location (~1 km)	✓	✓
Detailed score /100	—	✓
5 scored pillars	—	✓
Sourced indicators	—	✓
Synthesis	—	✓

Pricing

Discover

€0

Try the list and summaries, no key, for free.

Data DC

€2,000/yr

Up to 30 fiches/day · 300/year

Full fiche access: detailed grades, 5 pillars, sourced indicators, synthesis.

Request access

High volume

Above 30/day or 300/year, or embedding the data at scale? Get in touch.

Get in touch

Used for ESG reportingSite selectionAcademic researchMarket intelligenceJournalism

Get your key

After payment, come back here and grab your key in one click — no email to wait for.

I've paid, reveal my key →

Authentication

The key goes in the X-API-Key header, only. A key in a URL query (?api_key=) does not authenticate and returns 401 — so a key never leaks into logs.

Error codes

Code	Type	When
400	`bad_id`	malformed id
401	`missing_key`	missing X-API-Key header
403	`invalid_key`	unknown or revoked key
404	`not_found`	fiche not found
405	`method_not_allowed`	non-GET verb
429	`quota_exceeded`	daily/annual quota exceeded