Skip to main content
GET
Search Energy Owners

Authorizations

Authorization
string
header
required

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

Query Parameters

q
string

Search owner name, abbreviation, GEM Entity ID, or external ID.

Alias for q.

entity_id
string

Exact GEM ownership entity ID.

country
string

Country filter — matches an owner's registration or headquarters country. Accepts a country name, ISO-2, or ISO-3 via the shared resolveCountryInput layer (combinable with region/continent); an unresolvable value returns 400 INVALID_COUNTRY.

region
string

Region expanded to ISO-3 countries; matches registration or headquarters country.

continent
string

Continent expanded to ISO-3 countries; matches registration or headquarters country.

entity_type
string

Comma-separated GEM owner entity types.

publicly_listed
boolean

Filter by public-listing status.

limit
integer
default:25

Rows per page.

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

Pagination cursor from pagination.next_cursor.

Response

Success

success
enum<boolean>
required
Available options:
true
data
object[]
required
pagination
object
required
applied_filters
object