Skip to main content
GET
/
api
/
v2
/
energy
/
assets
/
summary
Summarize Energy Assets
curl --request GET \
  --url https://gdeltcloud.com/api/v2/energy/assets/summary \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "group_by": "tracker",
  "data": [
    {
      "bucket": "solar",
      "bucket_kind": "tracker",
      "asset_count": 103940,
      "capacity_mw_total": 210000,
      "capacity_mw_avg": 82.4,
      "capacity_mw_max": 3500,
      "capacity_mw_min": 1,
      "status_counts": {
        "operating": 65000,
        "construction": 7000,
        "proposed": 28000,
        "cancelled": 2000,
        "retired": 100
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

​
group_by
enum<string>
default:tracker

Summary aggregation dimension.

Available options:
country,
region,
continent,
tracker,
status,
start_year_decade,
fuel,
tier
​
tracker
string

Comma-separated GEM trackers. Valid values: coal_plants, coal_mines, coal_terminals, oil_gas_plants, oil_gas_extraction, lng_terminals, nuclear, geothermal, bioenergy, hydropower, solar, wind, gas_pipelines, oil_pipelines, lng_carriers. Omit for all trackers.

Example:

"coal_plants,solar"

​
country
string

Plain English country name, ISO-3, or legacy FIPS alias. Filters primary or secondary country for cross-border assets.

Example:

"United States"

​
region
string

Plain English region. Expands to the same ISO-3 country list used by V2 Events.

Example:

"Middle East"

​
continent
string

Plain English continent. Expands to the same ISO-3 country list used by V2 Events.

Example:

"Asia"

​
status
string

Comma-separated GEM status values. Common values include operating, construction, pre-construction, permitted, announced, proposed, shelved, cancelled, retired, and mothballed.

Example:

"operating,construction"

​
operating_only
boolean
default:false

Shorthand for status=operating.

​
tier
string

Comma-separated within-tracker tier values such as main, utility, distributed, below_threshold, closed, or sub_threshold.

Example:

"main,utility"

​
fuel
string

Comma-separated fuel values. Matches the tracker-native fuel string or normalized cross-tracker fuel where populated.

Example:

"coal,solar"

​
capacity_mw_min
number

Minimum MW capacity. Meaningful for power-generation trackers only.

Required range: x >= 0
​
capacity_mw_max
number

Maximum MW capacity. Meaningful for power-generation trackers only.

Required range: x >= 0
​
start_year_min
integer

Minimum asset start year.

Required range: 1700 <= x <= 2200
​
start_year_max
integer

Maximum asset start year.

Required range: 1700 <= x <= 2200
​
retired_year_min
integer

Minimum asset retired year.

Required range: 1700 <= x <= 2200
​
retired_year_max
integer

Maximum asset retired year.

Required range: 1700 <= x <= 2200
​
owner_search
string

Case-insensitive substring match against the raw owner string.

Example:

"ExxonMobil"

​
owner_entity_id
string

GEM Entity ID. Returns assets where the entity appears in owners, operators, or parents.

Example:

"E100002021305"

​
bbox
string

Viewport filter formatted as lat_min,lon_min,lat_max,lon_max.

Pattern: ^-?\d+(\.\d+)?,-?\d+(\.\d+)?,-?\d+(\.\d+)?,-?\d+(\.\d+)?$
Example:

"30,-105,33,-100"

​
near
string

Proximity filter formatted as lat,lon,radius_km.

Pattern: ^-?\d+(\.\d+)?,-?\d+(\.\d+)?,\d+(\.\d+)?$
Example:

"31.16,-102.9,50"

​
asset_class
enum<string>
default:fixed

Asset class. The default fixed excludes mobile LNG carriers; use mobile or all for vessels.

Available options:
fixed,
mobile,
all
​
summary_limit
integer
default:50

Number of summary buckets to return.

Required range: 1 <= x <= 500

Response

Success

​
success
enum<boolean>
required
Available options:
true
​
group_by
enum<string>
required
Available options:
country,
region,
continent,
tracker,
status,
start_year_decade,
fuel,
tier
​
data
object[]
required