Skip to main content
GET
/
api
/
v2
/
energy
/
assets
Search Energy Assets
curl --request GET \
  --url https://gdeltcloud.com/api/v2/energy/assets \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "oil_gas_plants:G100001090366",
      "gem_id": "G100001090366",
      "tracker": "oil_gas_plants",
      "tier": "main",
      "asset_class": "fixed",
      "name": "GW Ranch Energy Center",
      "name_local": null,
      "name_other": null,
      "status": "pre-construction",
      "status_detail": null,
      "start_year": 2028,
      "retired_year": null,
      "fuel": "fossil gas: natural gas",
      "capacity": {
        "value": 5000,
        "unit": "MW",
        "mw": 5000,
        "mw_secondary": null
      },
      "geo": {
        "country": "United States",
        "country_iso3": "USA",
        "secondary_country_iso3": null,
        "region": "North America",
        "subregion": "Northern America",
        "continent": "North America",
        "state_province": "Texas",
        "city": "Fort Stockton",
        "lat": 31.16,
        "lon": -102.9,
        "location_accuracy": "exact"
      },
      "owners_raw": "Pacifico GW LLC",
      "owners": [
        {
          "name": "Pacifico GW LLC",
          "entity_id": "E100002021305",
          "stake_pct": null
        }
      ],
      "operators_raw": null,
      "operators": [],
      "parents_raw": "Pacifico Energy Group LLC",
      "parents": [
        {
          "name": "Pacifico Energy Group LLC",
          "entity_id": "E100002021513",
          "stake_pct": null
        }
      ],
      "wiki_url": "https://www.gem.wiki/GW_Ranch_Energy_Center",
      "last_updated": "2026-01-15",
      "detail_url": "/energy/oil_gas_plants/G100001090366",
      "api_url": "/api/v2/energy/assets/oil_gas_plants/G100001090366"
    }
  ],
  "pagination": {
    "limit": 25,
    "cursor": null,
    "next_cursor": null
  },
  "sort": "capacity_desc",
  "filters_echo": {
    "tracker": [
      "oil_gas_plants"
    ],
    "country_iso3": [
      "USA"
    ],
    "status": [
      "pre-construction"
    ],
    "tier": [],
    "fuel": [],
    "capacity_mw_min": null,
    "capacity_mw_max": null,
    "start_year_min": null,
    "start_year_max": null,
    "owner_search": null,
    "owner_entity_id": null,
    "bbox": null,
    "near": null,
    "search": null,
    "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
​
sort
enum<string>
default:capacity_desc

List sort order.

Available options:
capacity_desc,
capacity_asc,
start_year_desc,
start_year_asc,
recent,
name
​
limit
integer
default:25

Number of asset cards to return.

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor from pagination.next_cursor.

Example:

"25"

Response

Success

​
success
enum<boolean>
required
Available options:
true
​
data
object[]
required
​
pagination
object
required
​
sort
string
required
​
filters_echo
object
required