DataCenterMap Developer API

A simple REST API for granular global data center data — search facilities by location, country, operator, and type, and retrieve per-facility estimated energy, cost, and carbon footprints, plus power-plant data. Get a free API key →

Base URL & authentication

All endpoints are served from https://api.datacentermap.info. Authenticate by sending your key in the x-api-key header. Rate limits and monthly quotas depend on your plan.

curl https://api.datacentermap.info/v1/datacenters?state=VA&limit=5 \
  -H "x-api-key: YOUR_API_KEY"

Endpoints

GET/v1/datacenters

Search and list data centers.

Param	Type	Description
`country`	string	Filter by country (e.g. `United States`).
`state`	string	US state code, e.g. `VA`.
`operator`	string	Operator name substring, e.g. `Equinix`.
`type`	string	`Hyperscale`, `Colocation`, or `Edge PoP`.
`near`	lat,lng	Center point for a radius search, e.g. `39.04,-77.49`.
`radius_km`	number	Radius in km (use with `near`).
`q`	string	Free-text match on name/operator/city.
`limit`	int	Max results (default 50, max 500).
`offset`	int	Pagination offset.

{
  "count": 1240,
  "limit": 5,
  "offset": 0,
  "results": [
    {
      "id": "aws-us-east-1",
      "name": "AWS US-East-1 Region",
      "operator": "Amazon AWS",
      "city": "Ashburn", "state": "VA", "country": "United States",
      "lat": 39.0438, "lng": -77.4874,
      "type": "Hyperscale",
      "estimated": { "kwh_per_day": 816000, "usd_per_day": 67728,
                     "kg_co2_per_day": 301104, "carbon_grade": "C" }
    }
  ]
}

GET/v1/datacenters/{id}

Retrieve a single facility by id, including its estimated energy, cost, and carbon footprint.

GET/v1/powerplants

List power plants (WRI Global Power Plant Database). Params: country, fuel, near, radius_km, min_mw, limit.

GET/v1/stats

Aggregate statistics: facility counts by type and country, and total estimated energy and cost.

Errors & rate limits

Responses use standard HTTP status codes. 401 = missing/invalid key, 403 = quota exceeded, 429 = rate limit exceeded (slow down and retry). Your remaining quota is returned in response headers.

Licensing

Facility data derives from OpenStreetMap (ODbL), the WRI Global Power Plant Database (CC-BY-4.0), and cited public sources; energy, cost, and carbon values are estimates. Attribution is required — see each record's source. View plans & get a key →