Map Energy Assets
Return map-ready Energy asset data. Without a single explicit country filter, the endpoint returns aggregate country-centroid rows. With exactly one country filter and no region or continent, it returns fine-grained asset pins capped by map_limit/fine_grained_limit.
Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
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.
"coal_plants,solar"
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.
"United States"
Plain English region. Expands to the same ISO-3 country list used by V2 Events.
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 "Middle East"
Plain English continent. Expands to the same ISO-3 country list used by V2 Events.
Africa, Asia, Europe, North America, South America, Oceania "Asia"
Comma-separated GEM status values. Common values include operating, construction, pre-construction, permitted, announced, proposed, shelved, cancelled, retired, and mothballed. See Taxonomy & Codes — Energy.
"operating,construction"
Shorthand for status=operating.
Comma-separated within-tracker tier values such as main, utility, distributed, below_threshold, closed, or sub_threshold.
"main,utility"
Comma-separated fuel values. Matches the tracker-native fuel string or normalized cross-tracker fuel where populated. See Taxonomy & Codes — Energy.
"coal,solar"
Minimum MW capacity. Meaningful for power-generation trackers only.
x >= 0Maximum MW capacity. Meaningful for power-generation trackers only.
x >= 0Minimum asset start year.
1700 <= x <= 2200Maximum asset start year.
1700 <= x <= 2200Minimum asset retired year.
1700 <= x <= 2200Maximum asset retired year.
1700 <= x <= 2200Canonical 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.
"ArcelorMittal"
Legacy — prefer the canonical entity param (still fully supported). Case-insensitive substring match against the raw owner string.
"ExxonMobil"
GEM Entity ID. Returns assets where the entity appears in owners, operators, or parents.
"E100002021305"
Viewport filter formatted as lat_min,lon_min,lat_max,lon_max.
^-?\d+(\.\d+)?,-?\d+(\.\d+)?,-?\d+(\.\d+)?,-?\d+(\.\d+)?$"30,-105,33,-100"
Proximity filter formatted as lat,lon,radius_km.
^-?\d+(\.\d+)?,-?\d+(\.\d+)?,\d+(\.\d+)?$"31.16,-102.9,50"
Case-insensitive substring match against asset name.
"Ranch Energy"
Asset class. The default fixed excludes mobile LNG carriers; use mobile or all for vessels.
fixed, mobile, all Fine-mode pin limit. Alias of fine_grained_limit.
50 <= x <= 1000Fine-mode pin limit. Alias of map_limit.
50 <= x <= 1000