Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl --request GET \
--url https://gdeltcloud.com/api/v2/energy/assets/{tracker}/{gem_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/energy/assets/{tracker}/{gem_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/energy/assets/{tracker}/{gem_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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"
},
"raw": {
"gem_id": "G100001090366",
"tracker": "oil_gas_plants",
"dataset_version": "2026-01"
}
}{
"error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
"code": "MISSING_API_KEY"
}{
"success": false,
"error": "Asset not found.",
"code": "NOT_FOUND"
}{
"success": false,
"error": "Rate limit or quota exceeded.",
"code": "RATE_LIMITED"
}{
"success": false,
"error": "Failed to fetch energy asset.",
"code": "INTERNAL_ERROR"
}Fetch one Energy asset by tracker and GEM ID. The response includes the canonical asset card plus a raw source record containing tracker-specific fields.
curl --request GET \
--url https://gdeltcloud.com/api/v2/energy/assets/{tracker}/{gem_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/energy/assets/{tracker}/{gem_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/energy/assets/{tracker}/{gem_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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"
},
"raw": {
"gem_id": "G100001090366",
"tracker": "oil_gas_plants",
"dataset_version": "2026-01"
}
}{
"error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
"code": "MISSING_API_KEY"
}{
"success": false,
"error": "Asset not found.",
"code": "NOT_FOUND"
}{
"success": false,
"error": "Rate limit or quota exceeded.",
"code": "RATE_LIMITED"
}{
"success": false,
"error": "Failed to fetch energy asset.",
"code": "INTERNAL_ERROR"
}GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
GEM tracker name. All trackers: Taxonomy & Codes — Energy.
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 GEM asset ID returned by Search Energy Assets.
