curl -X POST "https://gdeltcloud.com/api/v2/briefs" \
  -H "Authorization: Bearer $GDELT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope_text":"Monitor Red Sea maritime disruption risk across Yemen and the Gulf of Aden.","time_window":"7d","baseline_window":"30d","audience":"executive","countries":["YEM","SAU"]}'

import requests

url = "https://gdeltcloud.com/api/v2/briefs"

payload = { "scope_text": "Monitor Red Sea maritime disruption risk to shipping across Yemen, the Red Sea, and the Gulf of Aden." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    scope_text: 'Monitor Red Sea maritime disruption risk to shipping across Yemen, the Red Sea, and the Gulf of Aden.'
  })
};

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

{
  "id": "brief_123",
  "status": "queued",
  "brief_type": "monitoring_brief",
  "title": "Red Sea maritime disruption watch",
  "created_at": "2026-06-08T14:00:00Z",
  "web_url": "https://gdeltcloud.com/briefs/brief_123",
  "public_url": null,
  "message": "Brief generation started."
}