Search the unified facilities directory — one row per real-world facility, projected from three source silos and unified on a stable facility_id: Global Energy Monitor energy assets (plants, mines, terminals, pipelines — geography + spine owners), World Port Index ports (geography, no owner), and Epoch AI data centers (owner, no geography in v1). Every facility carries its owners as spine entity_ids, so a plant / terminal / field / data center joins to the cross-source entity graph. Filter by name, leaf type or coarse class, source silo, country/region/continent, owner (name or spine entity_id), status, capacity (MW), and geography (bbox / near). Directory-only in v1; the facility × event fusion is a separate stream. Plan-gated: requires the can_use_facilities entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Case-insensitive substring match on the facility name.
One or more leaf facility types (comma-separated). Invalid values return 400 INVALID_ENUM listing the accepted set.
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 Coarse class filter — grabs every leaf type in the class.
power, extraction, transport_logistics, ports, heavy_industry, digital_infrastructure Restrict to one or more source silos: gem (energy assets), maritime_ports (WPI ports), epoch (AI data centers).
gem, maritime_ports, epoch One or more country names or ISO-2/ISO-3 codes (comma-separated). Matches the facility's primary or secondary country.
One plain-English region (e.g. Middle East, South Asia). Expanded to its ISO-3 country list.
One plain-English continent (Asia, Europe, Africa, North America, South America, Oceania).
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.
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).
One or more operating-status values (comma-separated, case-insensitive): operating, construction, proposed, retired, cancelled… Vocabulary varies by silo.
Minimum capacity in MW (power facilities + data centers carry MW; ports/pipelines/extraction do not and are excluded when set).
x >= 0Maximum capacity in MW.
x >= 0true → only facilities with coordinates (excludes Epoch data centers, geo-null in v1); false → only those without.
true → only facilities with a resolved spine owner (excludes maritime ports); false → only those without.
Geographic viewport 'lat_min,lon_min,lat_max,lon_max'. Geo-null facilities are excluded.
Proximity query 'lat,lon,radius_km' — facilities within the radius of a point.
Result ordering.
name, capacity_desc, capacity_asc, recent, country Facility cards per page (max 100). Page deeper with cursor.
1 <= x <= 100Pagination cursor from pagination.next_cursor on the previous response.