API

A read-only JSON API over the same dataset you can download wholesale. No auth, no API keys; rate-limited per IP. Best for low-volume integrations and spot lookups — for analytical workloads, fetch the GeoJSON or CSV directly.

Base URL

https://api.gigawattmap.com

Rate limit

60 requests / minute / IP

Response cache

5 min fresh · 1 hr stale-while-revalidate

Spec

openapi.json

License inheritance

API responses inherit the license of the underlying source. Cables endpoints carry CC BY-NC-SA 3.0 (non-commercial). OSM-derived data is ODbL (share-alike). See the Data page for the full per-source breakdown.

GET/api/v1/datacenters

List datacenters

Returns a GeoJSON FeatureCollection of AI campuses, optionally filtered by bbox, operator, status, or limit. Backed by the same merged dataset that powers the map.

Query parameters

bboxstringminLon,minLat,maxLon,maxLat (WGS84). Excludes anything outside the box.
operatorstringCase-insensitive substring match on the operator field.
statusenumOne of operational | construction | announced | blocked.
limitintegerCap the result count. Server max 5000.

Example

curl 'https://api.gigawattmap.com/api/v1/datacenters?bbox=-100,30,-95,35&limit=10'

Response

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [-99.7339, 32.4487] },
      "properties": {
        "id": "stargate-i-abilene",
        "name": "Stargate I — Abilene",
        "operator": "OpenAI / Oracle / Crusoe",
        "status": "construction",
        "capacity_mw": 1200,
        "confidence": "high"
      }
    }
  ]
}

GET/api/v1/datacenters/:id

Single datacenter by id

Returns a single GeoJSON Feature. 404 when id does not match. Useful for resolving a permalink without scanning the full collection.

Example

curl 'https://api.gigawattmap.com/api/v1/datacenters/stargate-i-abilene'

Response

{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-99.7339, 32.4487] },
  "properties": { "id": "stargate-i-abilene", "name": "Stargate I — Abilene", ... }
}

GET/api/v1/powerplants

List power plants

Returns a GeoJSON FeatureCollection of utility-scale power plants from the Global Energy Monitor dataset. Same bbox / status / limit filters as datacenters.

Query parameters

bboxstringminLon,minLat,maxLon,maxLat (WGS84).
fuelstringFilter by fuel type, e.g. "gas", "nuclear".
limitintegerCap the result count.

Example

curl 'https://api.gigawattmap.com/api/v1/powerplants?bbox=-100,30,-95,35&fuel=gas'

Response

{ "type": "FeatureCollection", "features": [ ... ] }

GET/api/v1/announcements

Recent capex announcements

Returns the curated list of operator capex announcements with source URL and date. Hand-maintained; treat as a reading list, not a high-frequency feed.

Example

curl 'https://api.gigawattmap.com/api/v1/announcements'

Response

[
  {
    "id": "openai-stargate-2024-09",
    "operator": "OpenAI",
    "headline": "OpenAI announces Stargate buildout",
    "source_url": "https://...",
    "announced_at": "2024-09-23"
  }
]

GET/api/v1/tickers

Operator → ticker mappings

Returns the curated mapping from operator names to public-equity tickers. Used by the map ticker overlay; useful for joining capex exposure to listed companies.

Example

curl 'https://api.gigawattmap.com/api/v1/tickers'

Response

{
  "tickers": [
    { "symbol": "MSFT", "operators": ["Microsoft Azure"] },
    { "symbol": "GOOGL", "operators": ["Google Cloud"] }
  ]
}

GET/api/v1/openapi.json

Machine-readable spec

OpenAPI 3.1 description of every public endpoint. Generate clients with openapi-generator; the document is hand-curated so additionalProperties is always false.

Example

curl 'https://api.gigawattmap.com/api/v1/openapi.json'

Response

{ "openapi": "3.1.0", "info": { "title": "Gigawatt Map API", ... } }