Skip to main content
GET
Chokepoint transit activity

Authorizations

Authorization
string
header
required

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

Query Parameters

chokepoint
enum<string>

Restrict to one chokepoint (one of the 11 monitored straits). Omit for all.

Available options:
hormuz,
bab_el_mandeb,
malacca,
suez,
panama,
bosphorus,
gibraltar,
dover,
kerch,
taiwan,
danish_straits
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 7.

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

Rows per page (1–500).

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

Pagination cursor (offset) from a prior response's next_cursor.

Response

A page of chokepoint·hour rows, most recent first. Each row: chokepoint, hour, vessels, moving_vessels, avg_sog (average speed over ground, knots), positions (AIS message count). Standard envelope: { success, data, pagination, applied_filters }.

success
boolean
data
object[]
pagination
object
applied_filters
object