Skip to main content
GET
Area activity over time

Authorizations

Authorization
string
header
required

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

Query Parameters

chokepoint
enum<string>

Restrict to one chokepoint. Omit to use bbox / near / near_gem_id, or for global.

Available options:
hormuz,
bab_el_mandeb,
malacca,
suez,
panama,
bosphorus,
gibraltar,
dover,
kerch,
taiwan,
danish_straits
bbox
string

Bounding box filter: minLon,minLat,maxLon,maxLat (lon-first axis order, e.g. 56,26,57,27).

near
string

Point 'lat,lon' for a radius area; combine with radius_km (default 50 km).

near_gem_id
string

GEM energy-asset gem_id center — traffic within radius_km of that LNG terminal / platform (default 25 km). The cross-source 'traffic near energy infrastructure' join.

radius_km
number

Radius in km for near / near_gem_id. Default 50 (near) or 25 (near_gem_id); clamped 1–2000.

bucket
enum<string>

Time bucket. Auto-selects hour for spans ≤2 days, otherwise day.

Available options:
hour,
day
date_start
string

Window start YYYY-MM-DD (≤30-day window).

date_end
string

Window end YYYY-MM-DD.

days
integer

Trailing N-day window (1–30). Defaults to 14.

Required range: 1 <= x <= 30
limit
integer
default:200

Buckets per page (1–1000).

Required range: 1 <= x <= 1000

Response

Bucketed activity, most recent first. Envelope: { success, bucket ('hour'|'day'), data, pagination, applied_filters }. Each data row: bucket (timestamp), vessels (distinct mmsi), positions (AIS message count), moving_positions (sog > 1), avg_sog, max_sog (knots).

success
boolean
bucket
string
data
object[]
pagination
object
applied_filters
object