curl --request GET \
  --url https://gdeltcloud.com/api/v2/maritime/port-pulse \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://gdeltcloud.com/api/v2/maritime/port-pulse"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/maritime/port-pulse', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "port_id": "UAODS",
      "name": "Odesa",
      "unlocode": "UAODS",
      "country": "UKR",
      "country_name": "Ukraine",
      "lat": 46.49,
      "lon": 30.74,
      "harbor_size": "Medium",
      "lng_terminal": false,
      "oil_terminal": true,
      "relevant_events": 37,
      "conflict_events": 12,
      "events_last_7d": 9,
      "anomaly_ratio": 1.35,
      "energy_exposure": {
        "assets_nearby": 2,
        "state_owned": 1,
        "sanctions": 0,
        "china": 0
      },
      "pulse_level": "critical",
      "ais_coverage": {
        "status": "no_coverage",
        "nearest_chokepoint": null,
        "distance_km": null
      },
      "recent_events": [
        {
          "headline": "Port infrastructure struck in overnight attack",
          "family": "conflict",
          "event_date": "2026-06-13",
          "distance_km": 4,
          "cluster_id": "c_abc123",
          "cluster_date": "2026-06-13"
        }
      ]
    }
  ],
  "summary": {
    "ports": 6,
    "window_days": 14,
    "event_radius_km": 60,
    "ports_with_conflict": 4,
    "ports_active": 5
  },
  "applied_filters": {
    "country": "UKR",
    "days": 14,
    "event_radius_km": 60,
    "ignored": {}
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}