{ "openapi": "3.1.0", "info": { "title": "Datacenters API", "version": "1.0.0", "summary": "Announced AI data center builds with operator and tenant (companies.fru.dev slugs), place and coordinates, capacity in MW, chips, stated investment, dates and status, plus an append-only history of every dated change with its source", "description": "Announced AI data center builds with operator and tenant (companies.fru.dev slugs), place and coordinates, capacity in MW, chips, stated investment, dates and status, plus an append-only history of every dated change with its source. Refreshed daily at 14:30 UTC (news search on Tuesdays). Free to read; please cite \"Datacenters (datacenters.fru.dev)\" with a link. Responses are cached at the edge; keep to about 60 requests a minute. Guide: https://datacenters.fru.dev/agents", "contact": { "name": "fru.dev", "url": "https://fru.dev", "email": "fru.dev3@gmail.com" } }, "externalDocs": { "description": "For AI agents", "url": "https://datacenters.fru.dev/agents" }, "servers": [ { "url": "https://datacenters.fru.dev" } ], "paths": { "/api/builds": { "get": { "operationId": "list_builds", "summary": "AI data center builds, largest first by announced megawatts", "description": "AI data center builds, largest first by announced megawatts. Returns builds with id, name, operator, tenant, partners, city, region, country, lat, lon, mw, chips, capexB (USD billions), announced, targetOnline, status, summary, sources and the page URL.", "parameters": [ { "name": "status", "in": "query", "required": false, "description": "Only builds with this status", "schema": { "type": "string", "enum": [ "online", "partly online", "under construction", "announced", "paused", "cancelled" ] }, "example": "under construction" }, { "name": "company", "in": "query", "required": false, "description": "Only builds this company runs, rents or partners on (companies.fru.dev slug)", "schema": { "type": "string" }, "example": "openai" }, { "name": "country", "in": "query", "required": false, "description": "ISO country code", "schema": { "type": "string" }, "example": "US" }, { "name": "program", "in": "query", "required": false, "description": "A program such as stargate or fairwater", "schema": { "type": "string" }, "example": "stargate" }, { "name": "min_mw", "in": "query", "required": false, "description": "Only builds with at least this many MW announced", "schema": { "type": "integer" }, "example": 1000 }, { "name": "limit", "in": "query", "required": false, "description": "Items per page, 1 to 200", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 200 } }, { "name": "offset", "in": "query", "required": false, "description": "Items to skip, for the next page", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "builds with id, name, operator, tenant, partners, city, region, country, lat, lon, mw, chips, capexB (USD billions), announced, targetOnline, status, summary, sources and the page URL", "content": { "application/json": { "schema": { "type": "object" }, "example": { "builds": [ { "id": "meta-hyperion", "name": "Hyperion", "program": "", "operator": "meta", "tenant": "", "partners": [ "entergy" ], "city": "Richland Parish", "region": "Louisiana", "country": "US", "lat": 32.47, "lon": -91.63, "metro": "", "mw": 5000, "mwNote": "" }, { "id": "crusoe-wyoming-tallgrass", "name": "Crusoe Wyoming (Project Jade)", "program": "", "operator": "crusoe", "tenant": "", "partners": [ "tallgrass" ], "city": "Cheyenne area", "region": "Wyoming", "country": "US", "lat": 41.14, "lon": -104.82, "metro": "wyoming", "mw": 1800, "mwNote": "designed to scale to 10 GW" } ], "total": 11, "limit": 2, "offset": 0, "next": "/api/builds?min_mw=1000&limit=2&offset=2", "note": "Figures as announced by the operator or reported by the linked sources. mw and capexB are null when not stated. Builds with unverified tr..." } } } } } } }, "/api/builds/{id}": { "get": { "operationId": "get_build", "summary": "One build by id, with its full history", "description": "One build by id, with its full history. Returns the build, the companies involved, and every verified change (date, field, old, new, source).", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Build id, as in /builds/", "schema": { "type": "string" }, "example": "stargate-abilene" } ], "responses": { "200": { "description": "the build, the companies involved, and every verified change (date, field, old, new, source)", "content": { "application/json": { "schema": { "type": "object" }, "example": { "build": { "id": "stargate-abilene", "name": "Stargate Abilene", "program": "stargate", "operator": "oracle", "tenant": "openai", "partners": [ "crusoe", "lancium" ], "city": "Abilene", "region": "Texas", "country": "US", "lat": 32.5, "lon": -99.76, "metro": "texas", "mw": 1200, "mwNote": "" }, "companies": [ { "slug": "oracle", "name": "Oracle", "domain": "oracle.com" }, { "slug": "openai", "name": "OpenAI", "domain": "openai.com" } ], "history": [ { "id": 4, "at": "2026-03-06", "build": "stargate-abilene", "field": "mw", "old": "1800", "new": "1200", "note": "Oracle and OpenAI dropped the expansion to 2 GW", "source": "https://www.datacenterdynamics.com/en/news/oracleopenai-drop-plans-to-expand-flagship-abilene-stargate-site-meta-in-talks-to-pick-up-crus...", "by": "seed", "verified": true }, { "id": 3, "at": "2025-09-23", "build": "stargate-abilene", "field": "mw", "old": "1200", "new": "1800", "note": "A potential 600 MW expansion near the site", "source": "https://openai.com/index/five-new-stargate-sites/", "by": "seed", "verified": true } ], "url": "https://datacenters.fru.dev/builds/stargate-abilene", "note": "Figures as announced by the operator or reported by the linked sources. mw and capexB are null when not stated. Builds with unverified tr..." } } } }, "404": { "description": "Not found" } } } }, "/api/changes": { "get": { "operationId": "list_changes", "summary": "The append-only history: builds added, capacity, status, target date, tenant and investment changes, and dated updates, newest first", "description": "The append-only history: builds added, capacity, status, target date, tenant and investment changes, and dated updates, newest first. Returns changes with id, at (date of the change), build id, field, old, new, note, source URL, who logged it (seed, agent, admin) and the build page URL.", "parameters": [ { "name": "since", "in": "query", "required": false, "description": "Only changes dated at or after this day (YYYY-MM-DD)", "schema": { "type": "string" }, "example": "2026-06-01" }, { "name": "build", "in": "query", "required": false, "description": "Only this build id", "schema": { "type": "string" }, "example": "stargate-abilene" }, { "name": "limit", "in": "query", "required": false, "description": "Items per page, 1 to 200", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 200 } }, { "name": "offset", "in": "query", "required": false, "description": "Items to skip, for the next page", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "changes with id, at (date of the change), build id, field, old, new, note, source URL, who logged it (seed, agent, admin) and the build page URL", "content": { "application/json": { "schema": { "type": "object" }, "example": { "changes": [ { "id": 8, "at": "2026-09-24", "build": "stargate-dona-ana-project-jupiter", "field": "update", "old": "", "new": "Oracle sent a force majeure notice over Project Jupiter; the gas pipeline rights-of-way were refused in March and July", "note": "", "source": "https://thenextweb.com/news/oracle-force-majeure-project-jupiter-new-mexico", "by": "seed", "verified": true, "url": "https://datacenters.fru.dev/builds/stargate-dona-ana-project-jupiter" }, { "id": 45, "at": "2026-09-22", "build": "nebius-vineland", "field": "update", "old": "", "new": "NJ DEP fined the developer more than $1 million for running 62 gas generators without a permit", "note": "", "source": "https://whyy.org/articles/vineland-data-center-fined/", "by": "seed", "verified": true, "url": "https://datacenters.fru.dev/builds/nebius-vineland" } ], "total": 13, "limit": 3, "offset": 0, "next": "/api/changes?since=2026-06-01&limit=3&offset=3", "note": "Newest first, append-only. field: added, mw, status, target_online, tenant, capex (USD billions), operator, chips, or update (a dated eve..." } } } } } } }, "/api/companies": { "get": { "operationId": "list_companies", "summary": "Companies that run, rent or partner on a build, with their dated items (for the companies.fru.dev registry)", "description": "Companies that run, rent or partner on a build, with their dated items (for the companies.fru.dev registry). Returns companies with slug (companies.fru.dev slug), name, domain, the page URL here, and items: each build (type build, role, announced date) and each change (type change, date), with title, URL, mw and status.", "parameters": [ { "name": "since", "in": "query", "required": false, "description": "Only companies with an item dated at or after this day (YYYY-MM-DD)", "schema": { "type": "string" }, "example": "2026-06-01" }, { "name": "limit", "in": "query", "required": false, "description": "Items per page, 1 to 200", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 200 } }, { "name": "offset", "in": "query", "required": false, "description": "Items to skip, for the next page", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "companies with slug (companies.fru.dev slug), name, domain, the page URL here, and items: each build (type build, role, announced date) and each change (type change, date), with title, URL, mw and status", "content": { "application/json": { "schema": { "type": "object" }, "example": { "companies": [ { "slug": "openai", "name": "OpenAI", "domain": "openai.com", "url": "https://datacenters.fru.dev/companies/openai", "items": [ { "type": "change", "role": "tenant", "date": "2026-09-24", "title": "Project Jupiter (Stargate New Mexico): Oracle sent a force majeure notice over Project Jupiter; the gas pipeline rights-of-way were refus...", "url": "https://datacenters.fru.dev/builds/stargate-dona-ana-project-jupiter", "mw": null, "status": "under construction", "updated": "2026-09-24" }, { "type": "change", "role": "tenant", "date": "2026-09-10", "title": "Stargate UAE: The UAE is revising the 5 GW campus into a network of sites after attacks linked to the US-Iran war; G42 says work is progr...", "url": "https://datacenters.fru.dev/builds/stargate-uae", "mw": 1000, "status": "under construction", "updated": "2026-09-10" } ] }, { "slug": "oracle", "name": "Oracle", "domain": "oracle.com", "url": "https://datacenters.fru.dev/companies/oracle", "items": [ { "type": "change", "role": "operator", "date": "2026-09-24", "title": "Project Jupiter (Stargate New Mexico): Oracle sent a force majeure notice over Project Jupiter; the gas pipeline rights-of-way were refus...", "url": "https://datacenters.fru.dev/builds/stargate-dona-ana-project-jupiter", "mw": null, "status": "under construction", "updated": "2026-09-24" }, { "type": "change", "role": "partner", "date": "2026-09-10", "title": "Stargate UAE: The UAE is revising the 5 GW campus into a network of sites after attacks linked to the US-Iran war; G42 says work is progr...", "url": "https://datacenters.fru.dev/builds/stargate-uae", "mw": 1000, "status": "under construction", "updated": "2026-09-10" } ] } ], "total": 20, "limit": 2, "offset": 0, "next": "/api/companies?since=2026-06-01&limit=2&offset=2", "generated_at": "2026-09-24T23:03:16.143Z" } } } } } } }, "/api/locations": { "get": { "operationId": "list_locations", "summary": "Builds by US state and by country, with total megawatts", "description": "Builds by US state and by country, with total megawatts. Returns locations with key (us-tx style for states, ISO code for countries), label, builds, MW and the build ids.", "parameters": [], "responses": { "200": { "description": "locations with key (us-tx style for states, ISO code for countries), label, builds, MW and the build ids", "content": { "application/json": { "schema": { "type": "object" }, "example": { "locations": [ { "key": "us-tx", "label": "Texas", "country": "US", "builds": 6, "mw": 5700, "url": "https://datacenters.fru.dev/locations/us-tx", "builds_list": [ "vantage-frontier-shackelford", "stargate-abilene" ] }, { "key": "us-la", "label": "Louisiana", "country": "US", "builds": 1, "mw": 5000, "url": "https://datacenters.fru.dev/locations/us-la", "builds_list": [ "meta-hyperion" ] } ] } } } } } } }, "/api/search": { "get": { "operationId": "search", "summary": "Search builds, companies and places", "description": "Search builds, companies and places. Returns up to 20 ranked results with title, link and one line.", "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Build, company, city or state", "schema": { "type": "string" }, "example": "colossus" }, { "name": "limit", "in": "query", "required": false, "description": "Results, 1 to 20", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "responses": { "200": { "description": "up to 20 ranked results with title, link and one line", "content": { "application/json": { "schema": { "type": "object" }, "example": { "q": "colossus", "results": [ { "id": "b:xai-colossus-memphis", "group": "items", "title": "Colossus", "subtitle": "xAI · Memphis, Tennessee · Online", "href": "/builds/xai-colossus-memphis", "keywords": [ "Memphis", "Tennessee" ], "logo": "https://img.logo.dev/x.ai?token=...&size=64&format=png&theme=light&retina=true&fallback=404", "boost": 20, "score": 1045 }, { "id": "b:xai-colossus-2", "group": "items", "title": "Colossus 2", "subtitle": "xAI · Memphis, Tennessee · 946 MW · Online", "href": "/builds/xai-colossus-2", "keywords": [ "Memphis", "Tennessee" ], "logo": "https://img.logo.dev/x.ai?token=...&size=64&format=png&theme=light&retina=true&fallback=404", "boost": 20, "score": 843 } ] } } } } } } } } }