Skip to main content

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.

​
Overview

GDELT Cloud Energy Data exposes asset registries from Global Energy Monitor through the V2 API. Use it to anchor event, story, and entity analysis to physical energy infrastructure: power plants, mines, terminals, pipelines, extraction fields, renewable assets, LNG carriers, and ownership relationships.
Cite Global Energy Monitor for upstream asset facts. Cite GDELT Cloud for the API shape, derived rollups, geography expansion, parsed ownership arrays, and workflow outputs.

​
Coverage

The V2 Energy API reads from 15 GEM asset trackers:
TrackerAsset typeNative capacity
coal_plantsCoal plant unitsMW
coal_minesCoal minesMtpa
coal_terminalsCoal import/export terminalsMt
oil_gas_plantsOil and gas power plantsMW
oil_gas_extractionOil and gas extraction fieldsNot populated in the main sheet
lng_terminalsLNG import/export terminalsMtpa or Bcm/y
nuclearNuclear reactorsMW
geothermalGeothermal power assetsMW
bioenergyBioenergy power assetsMW
hydropowerHydropower projectsMW
solarUtility-scale solar assetsMW
windWind power assetsMW
gas_pipelinesGas pipelinesBcm/y or MMcf/d
oil_pipelinesOil and NGL pipelinesbpd
lng_carriersLNG carrierscbm
Stationary infrastructure is returned by default with asset_class=fixed. LNG carriers are mobile assets; request asset_class=mobile or asset_class=all when vessel coverage matters.

​
Geography

Energy geography follows the same country, region, and continent expansion as V2 Events. You can use plain English country names, ISO-3 codes, or supported legacy aliases: 
country=United States
region=Middle East
continent=Asia
For cross-border assets, such as pipelines and binational hydropower projects, filters match either country_iso3 or secondary_country_iso3.

​
Capacity

Every asset card includes a native capacity.value and capacity.unit. capacity.mw is populated only for power-generation trackers: 
{
  "capacity": {
    "value": 5000,
    "unit": "MW",
    "mw": 5000,
    "mw_secondary": null
  }
}
Do not sum capacity_mw_total across mixed unit families. For capacity rollups, constrain tracker to power-generation trackers or group by tracker and interpret each bucket separately.

​
Ownership

GEM owner, operator, and parent fields are exposed in two forms:
FieldMeaning
owners_raw, operators_raw, parents_rawVerbatim source strings from GEM
owners, operators, parentsParsed arrays of { name, entity_id, stake_pct }
Use owner_search for fuzzy text search against the raw owner string. Use owner_entity_id for exact GEM entity matching across owners, operators, and parents.

​
Refresh Cadence

GEM trackers are refreshed a few times per year as Global Energy Monitor publishes updated tracker files. GDELT Cloud updates Energy Data after those releases are available; do not expect daily or weekly tracker-level changes.

​
API Surface

The official V2 Energy API reference documents:
  • GET /api/v2/energy/assets
  • GET /api/v2/energy/assets/summary
  • GET /api/v2/energy/assets/map
  • GET /api/v2/energy/assets/{tracker}/{gem_id}
See API v2 for authentication, response envelope conventions, and generated endpoint pages.