GDELT Cloud Docs — Global Event Data API & MCP

{ "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" } }

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

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

Show child attributes

pagination

object

required

Show child attributes

sort

string

required

filters_echo

object

required

Show child attributes

applied_filters

object

Facilities

Events

Stories

Entities

Geography

Reference Data

Government

Energy

Briefs

Filings

Macro Finance

Maritime

Media Intelligence

Screening and Reference

China

Unified Search

AI Compute

Search Energy Assets

Authorizations

Query Parameters

Response