Skip to main content
GET
Search Facilities

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

q
string

Case-insensitive substring match on the facility name.

type
enum<string>[]

One or more leaf facility types (comma-separated). Invalid values return 400 INVALID_ENUM listing the accepted set.

Available options:
coal_plant,
oil_gas_plant,
nuclear_plant,
geothermal_plant,
bioenergy_plant,
hydropower_plant,
solar_farm,
wind_farm,
coal_mine,
oil_gas_field,
iron_ore_mine,
coal_terminal,
lng_terminal,
gas_pipeline,
oil_pipeline,
lng_carrier,
port,
steel_plant,
cement_plant,
chemical_plant,
data_center
class
enum<string>

Coarse class filter — grabs every leaf type in the class.

Available options:
power,
extraction,
transport_logistics,
ports,
heavy_industry,
digital_infrastructure
source
enum<string>[]

Restrict to one or more source silos: gem (energy assets), maritime_ports (WPI ports), epoch (AI data centers).

Available options:
gem,
maritime_ports,
epoch
country
string

One or more country names or ISO-2/ISO-3 codes (comma-separated). Matches the facility's primary or secondary country.

region
string

One plain-English region (e.g. Middle East, South Asia). Expanded to its ISO-3 country list.

continent
string

One plain-English continent (Asia, Europe, Africa, North America, South America, Oceania).

entity
string

Canonical owner selector — the same entity value works across endpoints (facilities, energy, gov). Pass a spine entity id (e_..., from /api/v2/search) for an EXACT owner match, or any name for a case-insensitive fuzzy owner-name match. Preferred over the legacy owner_search / owner_entity_id params below.

owner_entity_id
string

Spine entity_id (e_...). Returns facilities this entity owns/operates. Also expressible as the canonical entity=<e_ id>. Resolve a name via /api/v2/search.

Legacy — prefer the canonical entity param (still fully supported). Case-insensitive substring match on the owner name (no id needed).

status
string

One or more operating-status values (comma-separated, case-insensitive): operating, construction, proposed, retired, cancelled… Vocabulary varies by silo.

capacity_mw_min
number

Minimum capacity in MW (power facilities + data centers carry MW; ports/pipelines/extraction do not and are excluded when set).

Required range: x >= 0
capacity_mw_max
number

Maximum capacity in MW.

Required range: x >= 0
has_geo
boolean

true → only facilities with coordinates (excludes Epoch data centers, geo-null in v1); false → only those without.

has_owner
boolean

true → only facilities with a resolved spine owner (excludes maritime ports); false → only those without.

bbox
string

Geographic viewport 'lat_min,lon_min,lat_max,lon_max'. Geo-null facilities are excluded.

near
string

Proximity query 'lat,lon,radius_km' — facilities within the radius of a point.

sort
enum<string>
default:name

Result ordering.

Available options:
name,
capacity_desc,
capacity_asc,
recent,
country
limit
integer
default:25

Facility cards per page (max 100). Page deeper with cursor.

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

Pagination cursor from pagination.next_cursor on the previous response.

Response

Success

success
boolean
data
object[]
pagination
object
applied_filters
object

Echo of the resolved filters.