API.

The datacenters.world API is a read-only REST interface over the same dataset that powers the public map and editorial pages.

• 5,675 data center facilities across 148 countries
• 34,732 networks (ASNs) + 1,309 internet exchanges
• 176 public cloud regions across AWS, Google, Azure, Oracle

JSON by default, CSV via ?format=csv. All responses are edge-cached with stale-while-revalidate and any-origin CORS. Sources include PeeringDB, OpenStreetMap, operator-published facility pages (Equinix, Digital Realty, DataBank, Cologix, CoreSite, CyrusOne, QTS, Iron Mountain), datacenters.google, and datacenters.atmeta.com.

Sixty seconds end to end: sign in with GitHub, generate a key on the dashboard, then list the 5 largest German Equinix sites:

const res = await fetch(
  'https://datacenters.world/api/v1/facilities?country=DE&operator=Equinix&limit=5',
  { headers: { Authorization: 'Bearer dcw_…' } }
);
const { data, meta } = await res.json();
console.log(data, meta);

Free tier is 1,000 requests/month — no card required. Quota resets monthly on your signup anniversary (free) or billing cycle (paid).

Every request needs a key passed as Authorization: Bearer dcw_…. Unauthenticated calls return 401 Unauthorized.

const res = await fetch(
  'https://datacenters.world/api/v1/facilities?country=DE&limit=5',
  { headers: { Authorization: 'Bearer dcw_…' } }
);

Keys are dcw_ + 43 base64url chars (256 bits of entropy fromcrypto.randomBytes). The plaintext is shown once at creation and stored sha256-hashed at rest. Lost a key? Revoke and regenerate from the dashboard — there’s no recovery path.

Every successful response sets X-RateLimit-Tier, X-RateLimit-Limit, and X-RateLimit-Remaining. See Errors & rate limits for the over-quota behavior.

Five endpoints, all GET. Each one accepts ?format=csv in addition to JSON.

const res = await fetch(
  'https://datacenters.world/api/v1/facilities?country=US&limit=2',
  { headers: { Authorization: 'Bearer dcw_…' } }
);
const { data, meta } = await res.json();

{
  "data": [
    {
      "slug": "equinix-inc-equinix-dc1-...",
      "name": "Equinix DC1-DC15,DC21-DC22 - Ashburn",
      "operator": "Equinix, Inc.",
      "code": null,
      "city": "Ashburn",
      "country": "US",
      "lat": 39.018593,
      "lng": -77.539233,
      "status": "operational",
      "power_mw": null,
      "space_sqft": null,
      "ups_redundancy": null,
      "uptime_sla": null,
      "network_count": 504,
      "ix_count": 7
    }
  ],
  "meta": {
    "total": 1394,
    "returned": 2,
    "limit": 2,
    "offset": 0,
    "next_offset": 2
  }
}

const slug = 'equinix-inc-equinix-ny2-ny4-ny5-ny6-new-york-secaucus-secaucus';
const res = await fetch(`https://datacenters.world/api/v1/facilities/${slug}`, {
  headers: { Authorization: 'Bearer dcw_…' },
});
const { data } = await res.json();

{
  "data": {
    "slug": "equinix-inc-equinix-ny2-...",
    "name": "Equinix NY2/NY4/NY5/NY6 - New York, Secaucus",
    "operator": "Equinix, Inc.",
    "power_mw": null,
    "space_sqft": 129436,
    "tier": null,
    "year_built": null,
    "pue": null,
    "ups_redundancy": "N+1",
    "uptime_sla": "99.9999%+",
    "certifications": ["FISMA", "HIPAA", "ISO 27001", "..."],
    "networks": [ /* 129 ASNs, each with name, asn, irr_policy */ ],
    "ixes":     [ /* 10 internet exchanges with member counts */ ],
    "sources":  [ /* 5 provenance records: source, source_url, fetched_at */ ],
    "network_count": 129,
    "ix_count": 10
  }
}

const res = await fetch('https://datacenters.world/api/v1/operators?limit=5', {
  headers: { Authorization: 'Bearer dcw_…' },
});
const { data } = await res.json();

{
  "data": [
    { "operator": "Equinix, Inc.",            "facility_count": 263, "country_count": 35 },
    { "operator": "Digital Realty",           "facility_count": 220, "country_count": 22 },
    { "operator": "CyrusOne Inc.",            "facility_count":  83, "country_count":  9 },
    { "operator": "DataBank, Ltd.",           "facility_count":  78, "country_count":  2 },
    { "operator": "QTS Realty Trust, Inc.",   "facility_count":  61, "country_count":  3 }
  ],
  "meta": { "total": 5 }
}

const res = await fetch('https://datacenters.world/api/v1/countries', {
  headers: { Authorization: 'Bearer dcw_…' },
});
const { data } = await res.json();

{
  "data": [
    { "country": "US", "country_name": "United States", "facility_count": 1394 },
    { "country": "DE", "country_name": "Germany",        "facility_count":  359 },
    { "country": "BR", "country_name": "Brazil",         "facility_count":  303 }
  ],
  "meta": { "total": 148 }
}

const res = await fetch(
  'https://datacenters.world/api/v1/cloud-regions?provider=aws&country=DE',
  { headers: { Authorization: 'Bearer dcw_…' } }
);
const { data } = await res.json();

{
  "data": [
    {
      "provider": "aws",
      "code": "eu-central-1",
      "name": "Europe (Frankfurt)",
      "city": "Frankfurt",
      "country": "DE",
      "lat": 50.1109,
      "lng": 8.6821,
      "launched_year": 2014
    }
  ],
  "meta": { "total": 1 }
}

The same atlas, exposed as Model Context Protocol tools. Add the endpoint below to Claude Desktop, Cursor, Claude Code, or any other MCP-aware client and your AI gets typed access to facilities, operators, networks, IXPs, and cloud regions — citations included.

Client config

{
  "mcpServers": {
    "datacenters-world": {
      "url": "https://datacenters.world/api/mcp",
      "headers": {
        "Authorization": "Bearer dcw_…"
      }
    }
  }
}

claude mcp add datacenters-world \
  --transport http \
  --header "Authorization: Bearer dcw_…" \
  https://datacenters.world/api/mcp

{
  "mcpServers": {
    "datacenters-world": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://datacenters.world/api/mcp",
        "--header",
        "Authorization: Bearer dcw_…"
      ]
    }
  }
}

Tools

All five tools return a source_url pointing at the canonical facility / operator / IXP page so your AI can cite back to the dataset.

Quota note: each MCP tool call counts as one request against your monthly quota — same path as /api/v1/*. AI agents typically fan out 3–6 tool calls per chat turn, so budget accordingly. Free tier (1,000/month) covers roughly 150–300 chat conversations.

Non-2xx responses use a uniform error envelope:

const res = await fetch('https://datacenters.world/api/v1/facilities', {
  headers: { Authorization: 'Bearer dcw_…' },
});
if (!res.ok) {
  const { error } = await res.json();
  // error.status, error.message, optional details
}

Rate-limit headers on every successful response: X-RateLimit-Tier (free | pro | team | enterprise), X-RateLimit-Limit (monthly cap), and X-RateLimit-Remaining. Quotas roll over on the 1st of each month in UTC.

Pro and Team ship with a 3-day free trial via Polar.sh — no charge until day 4, cancel anytime. Upgrades take effect immediately and every active key on your account inherits the new tier. Manage from the dashboard.

All endpoints live under /api/v1/. Breaking changes ship under a new major (/api/v2/) — never inside v1. Additive changes (new optional query params, new response fields) ship without version bump.

Deprecation policy: any field or param removed from v1gets at least 90 days’ notice via the Deprecation response header and a note here.