Skip to main content
GET
/
api
/
v2
/
energy
/
assets
/
map
Map Energy Assets
curl --request GET \
  --url https://gdeltcloud.com/api/v2/energy/assets/map \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "mode": "aggregate",
  "data": [
    {
      "kind": "aggregate",
      "country_iso3": "USA",
      "country": "United States",
      "lat": 39.5,
      "lon": -98.35,
      "asset_count": 1200,
      "capacity_mw_total": 250000,
      "top_tracker": "solar",
      "trackers": [
        "coal_plants",
        "solar",
        "wind"
      ]
    }
  ],
  "filters_echo": {
    "tracker": [],
    "country_iso3": [
      "USA"
    ],
    "status": [],
    "tier": [],
    "fuel": [],
    "operating_only": false,
    "asset_class": "fixed"
  }
}

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

​
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"

​
search
string

Case-insensitive substring match against asset name.

Example:

"Ranch Energy"

​
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
​
map_limit
integer
default:300

Fine-mode pin limit. Alias of fine_grained_limit.

Required range: 50 <= x <= 1000
​
fine_grained_limit
integer
default:300

Fine-mode pin limit. Alias of map_limit.

Required range: 50 <= x <= 1000

Response

Success

​
success
enum<boolean>
required
Available options:
true
​
mode
enum<string>
required
Available options:
aggregate,
fine
​
data
object[]
required
​
filters_echo
object
required