curl --request GET \
--url https://gdeltcloud.com/api/v2/epoch/data-centers \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/epoch/data-centers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/epoch/data-centers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"name": "Fairwater (Mount Pleasant)",
"owner": "Microsoft",
"current_power_mw": 300,
"current_h100e": 400000,
"current_capital_cost_busd": 3.3,
"country": "United States",
"users": "OpenAI",
"current_chip_types": "NVIDIA GB200",
"entity_id": "e_11223344aabbccdd",
"entity_page_name": "Microsoft"
}
],
"by_country": [
{
"country": "United States",
"data_centers": 42,
"power_mw_total": 5200,
"h100e_total": 6100000,
"capital_cost_busd_total": 58.4
}
],
"totals": {
"n": 71,
"power_mw": 7300,
"h100e": 8400000,
"capital_cost_busd": 79.1
},
"pagination": {
"limit": 25,
"offset": 0,
"next_cursor": null,
"next_offset": null
},
"applied_filters": {
"owner": "Microsoft",
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}AI data centers
Epoch compute and finance observations linked to physical Facilities. Curated inventory totals are not a worldwide census; participant roles and ownership certainty remain explicit.
curl --request GET \
--url https://gdeltcloud.com/api/v2/epoch/data-centers \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/epoch/data-centers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/epoch/data-centers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"name": "Fairwater (Mount Pleasant)",
"owner": "Microsoft",
"current_power_mw": 300,
"current_h100e": 400000,
"current_capital_cost_busd": 3.3,
"country": "United States",
"users": "OpenAI",
"current_chip_types": "NVIDIA GB200",
"entity_id": "e_11223344aabbccdd",
"entity_page_name": "Microsoft"
}
],
"by_country": [
{
"country": "United States",
"data_centers": 42,
"power_mw_total": 5200,
"h100e_total": 6100000,
"capital_cost_busd_total": 58.4
}
],
"totals": {
"n": 71,
"power_mw": 7300,
"h100e": 8400000,
"capital_cost_busd": 79.1
},
"pagination": {
"limit": 25,
"offset": 0,
"next_cursor": null,
"next_offset": null
},
"applied_filters": {
"owner": "Microsoft",
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Number of records to return on this page; use the returned continuation to request the next page. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 200Continuation from pagination.next_cursor in the previous response. Keep the other filters unchanged; null means no next page. Also accepts: offset. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Participant entity: spine ID, news ID, Wikipedia URL or resolved name; all terminal aliases are included. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#entity_handle
Exact source role. Hardware ownership does not establish building ownership. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Country name, ISO-2 or ISO-3. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#country
Shared geographic region. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#region
Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean Shared continent. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#continent
Africa, Asia, Europe, North America, South America, Oceania Owner substring; entity selects resolved participants. Also accepts: org. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Response
A page of data centers plus a country rollup and totals. Envelope: { success, data, by_country, totals, pagination, applied_filters }.