Skip to main content
GET
Summarize Energy Assets

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. All trackers: Taxonomy & Codes — Energy.

Example:

"coal_plants,solar"

​
country
string

Country filter, resolved through the shared resolveCountryInput layer: a country name (United States), ISO-2 (US), ISO-3 (USA), or legacy alias all work. Filters primary or secondary country for cross-border assets; combinable with region/continent and an unresolvable value returns 400 INVALID_COUNTRY.

Example:

"United States"

​
region
enum<string>

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

Available options:
Africa,
Asia,
Middle East,
Northern Africa,
Western Africa,
Eastern Africa,
Middle Africa,
Southern Africa,
Europe,
Eastern Europe,
South Asia,
Southeast Asia,
East Asia,
Central Asia,
North America,
Central America,
Caribbean,
South America,
Oceania
Example:

"Middle East"

​
continent
enum<string>

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

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
Example:

"Asia"

​
status
string

Comma-separated GEM status values. Common values include operating, construction, pre-construction, permitted, announced, proposed, shelved, cancelled, retired, and mothballed. See Taxonomy & Codes — Energy.

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. See Taxonomy & Codes — Energy.

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
​
entity
string

Canonical owner selector — the same entity value works across endpoints. Pass a spine entity id (e_...) for an EXACT match against an asset's owners, operators, or parents, or any name for a case-insensitive fuzzy owner-name match. Preferred over the legacy owner_search param.

Example:

"ArcelorMittal"

​
owner_search
string

Legacy — prefer the canonical entity param (still fully supported). 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
​
applied_filters
object