Data Centers

Get all data centers

curl --request GET \
  --url https://api.cleanview.co/api/v1/data-centers \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.cleanview.co/api/v1/data-centers"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.cleanview.co/api/v1/data-centers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cleanview.co/api/v1/data-centers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cleanview.co/api/v1/data-centers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cleanview.co/api/v1/data-centers")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cleanview.co/api/v1/data-centers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "metadata": {
    "total_count": 1176,
    "generated_at": "2024-12-12T10:00:00.000Z"
  },
  "customer": {
    "id": "test_user_001",
    "name": "Test Developer"
  },
  "data": [
    {
      "project_name": "Stream Data Center: Genesse County",
      "developer": "Stream Data Centers",
      "status": "Planned",
      "operating_year": null,
      "capacity_mw": 250.0,
      "land_acres": null,
      "building_square_footage": 900000,
      "cap_ex": 6300000000,
      "county": "Genesse",
      "state": "NY",
      "latitude": null,
      "longitude": null,
      "source_1": "https://www.datacenterdynamics.com/en/news/stream-proposes-large-data-center-in-genesee-county-new-york/",
      "source_2": null,
      "source_3": null
    },
    {
      "project_name": "Core Scientific: Cottonwood 1 & 2",
      "developer": "Core Scientific",
      "status": "Planned",
      "operating_year": null,
      "capacity_mw": 250.0,
      "land_acres": 100,
      "building_square_footage": 125000,
      "cap_ex": null,
      "county": "Reeves",
      "state": "TX",
      "latitude": 31.54923296,
      "longitude": -103.8337321,
      "source_1": "https://corescientific.com/high-density-data-centers/pecos-tx/",
      "source_2": null,
      "source_3": null
    }
  ]
}

GET

data-centers

Get all data centers

curl --request GET \
  --url https://api.cleanview.co/api/v1/data-centers \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.cleanview.co/api/v1/data-centers"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.cleanview.co/api/v1/data-centers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cleanview.co/api/v1/data-centers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cleanview.co/api/v1/data-centers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cleanview.co/api/v1/data-centers")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cleanview.co/api/v1/data-centers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "metadata": {
    "total_count": 1176,
    "generated_at": "2024-12-12T10:00:00.000Z"
  },
  "customer": {
    "id": "test_user_001",
    "name": "Test Developer"
  },
  "data": [
    {
      "project_name": "Stream Data Center: Genesse County",
      "developer": "Stream Data Centers",
      "status": "Planned",
      "operating_year": null,
      "capacity_mw": 250.0,
      "land_acres": null,
      "building_square_footage": 900000,
      "cap_ex": 6300000000,
      "county": "Genesse",
      "state": "NY",
      "latitude": null,
      "longitude": null,
      "source_1": "https://www.datacenterdynamics.com/en/news/stream-proposes-large-data-center-in-genesee-county-new-york/",
      "source_2": null,
      "source_3": null
    },
    {
      "project_name": "Core Scientific: Cottonwood 1 & 2",
      "developer": "Core Scientific",
      "status": "Planned",
      "operating_year": null,
      "capacity_mw": 250.0,
      "land_acres": 100,
      "building_square_footage": 125000,
      "cap_ex": null,
      "county": "Reeves",
      "state": "TX",
      "latitude": 31.54923296,
      "longitude": -103.8337321,
      "source_1": "https://corescientific.com/high-density-data-centers/pecos-tx/",
      "source_2": null,
      "source_3": null
    }
  ]
}

Overview

The Data Centers endpoint provides access to a curated database of data center projects across the United States. This dataset includes information about planned, operating, and cancelled data center facilities, with details on power capacity, land usage, capital expenditure, and geographic location. This is a “download link” style endpoint that returns all audit-approved records in a single response. There is no pagination - all approved data center records are returned at once.

Common Status Values

Status	Description
`Planned`	Project is planned but not yet operational
`Operating`	Data center is currently operational
`Cancelled`	Project has been cancelled or postponed

Geographic Coverage

Data centers are tracked across multiple states with the highest concentrations in:

Virginia (VA) - Northern Virginia data center corridor
Texas (TX) - Major metro areas including Dallas-Fort Worth, Austin, San Antonio
Georgia (GA) - Atlanta metro area
Arizona (AZ) - Phoenix metro area
California (CA) - Bay Area and Los Angeles

All records returned have been audit-approved by our data team to ensure accuracy and completeness.

Example Requests

Get All Data Centers

curl -H "x-api-key: your_api_key_here" \
  "https://api.cleanview.co/api/v1/data-centers"

Returns all audit-approved data center records in a single response.

Response Schema

{
  "success": true,
  "metadata": {
    "total_count": 1176,
    "generated_at": "2024-12-12T10:00:00.000Z"
  },
  "customer": {
    "id": "test_user_001",
    "name": "Test Developer"
  },
  "data": [
    {
      "project_name": "Stream Data Center: Genesse County",
      "developer": "Stream Data Centers",
      "status": "Planned",
      "operating_year": null,
      "capacity_mw": 250.0,
      "land_acres": null,
      "building_square_footage": 900000,
      "cap_ex": 6300000000,
      "county": "Genesse",
      "state": "NY",
      "latitude": null,
      "longitude": null,
      "source_1": "https://www.datacenterdynamics.com/en/news/stream-proposes-large-data-center-in-genesee-county-new-york/",
      "source_2": null,
      "source_3": null
    },
    {
      "project_name": "Core Scientific: Cottonwood 1 & 2",
      "developer": "Core Scientific",
      "status": "Planned",
      "operating_year": null,
      "capacity_mw": 250.0,
      "land_acres": 100,
      "building_square_footage": 125000,
      "cap_ex": null,
      "county": "Reeves",
      "state": "TX",
      "latitude": 31.54923296,
      "longitude": -103.8337321,
      "source_1": "https://corescientific.com/high-density-data-centers/pecos-tx/",
      "source_2": null,
      "source_3": null
    }
  ]
}

Response Fields

Metadata Section

Field	Type	Description
`success`	boolean	Indicates if the request was successful
`total_count`	number	Total number of data center records returned
`generated_at`	string	ISO 8601 timestamp when response was generated

Data Center Fields

Field	Type	Description
`project_name`	string	Name of the data center project
`developer`	string	Developer or operator of the data center
`status`	string	Project status (Planned, Operating, Cancelled, etc.)
`operating_year`	number	Year the facility began or will begin operations (if known)
`capacity_mw`	number	Power capacity in megawatts (MW)
`land_acres`	number	Land area in acres
`building_square_footage`	number	Building area in square feet
`cap_ex`	number	Capital expenditure (investment amount in USD)
`county`	string	County where the data center is located
`state`	string	Two-letter state code where data center is located
`latitude`	number	Latitude coordinate of the facility
`longitude`	number	Longitude coordinate of the facility
`source_1`	string	Primary source URL for the data center information
`source_2`	string	Secondary source URL (if available)
`source_3`	string	Tertiary source URL (if available)

Null Values: Many fields may contain null values when specific information is not available. This is particularly common for operating_year, capacity_mw, latitude, and longitude fields on newly announced projects.

Data Quality Notes

All returned records have audit_approved = true, indicating they have been reviewed and validated by our data team
Source URLs are provided for transparency and verification
Geographic coordinates (latitude/longitude) are included when available and accurate
Capacity and financial data (capacity_mw, cap_ex) may be estimates based on public announcements
Some projects may have multiple source URLs for cross-verification

Large Response Size: This endpoint returns all approved records in a single response. The response size can be 500KB or more depending on the current dataset. Ensure your application can handle this payload size.

Use Cases

This endpoint is ideal for:

Market Analysis: Understanding data center development trends by region, developer, or capacity
Location Intelligence: Mapping data center locations and analyzing geographic clustering
Competitive Research: Tracking which developers are active in specific markets
Energy Planning: Analyzing power capacity requirements and grid impact
Real Estate Analysis: Understanding land and building size requirements for data center projects

Data Updates

The data center database is continuously updated as new projects are announced or existing projects reach new milestones. All updates go through an audit approval process before being exposed via the API.

Authorizations

x-api-key

string

header

required

API key authentication using x-api-key header

Response

Successful response with all data centers

success

boolean

required

Always true for successful responses

Example:

true

metadata

object

required

Show child attributes

customer

object

required

Customer information for the API key

Show child attributes

data

object[]

required

Array of all audit-approved data center records

Show child attributes

Unified Projects

Overview

EIA Data

Interconnection Queues

Projects

Data Centers

Overview

Common Status Values

Geographic Coverage

Example Requests

Response Schema

Response Fields

Metadata Section

Data Center Fields

Data Quality Notes

Use Cases

Data Updates

Authorizations

Response

​Overview

​Common Status Values

​Geographic Coverage

​Example Requests

​Response Schema

​Response Fields

​Metadata Section

​Data Center Fields

​Data Quality Notes

​Use Cases

​Data Updates

Authorizations

Response

Overview

Common Status Values

Geographic Coverage

Example Requests

Response Schema

Response Fields

Metadata Section

Data Center Fields

Data Quality Notes

Use Cases

Data Updates