Documentation IndexFetch the complete documentation index at: /llms.txtUse this file to discover all available pages before exploring further.
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
cURL
curl "https://gdeltcloud.com/api/v2/briefs" \ -H "Authorization: Bearer $GDELT_CLOUD_API_KEY"
import requests url = "https://gdeltcloud.com/api/v2/briefs" 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/briefs', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));
{ "briefs": [ { "id": "brief_123", "title": "Red Sea maritime disruption watch", "brief_type": "monitoring_brief", "status": "ready", "created_at": "2026-06-08T14:00:00Z", "updated_at": "2026-06-08T14:08:00Z", "error_message": null, "public_url": null, "web_url": "https://gdeltcloud.com/briefs/brief_123" } ] }
List the caller’s Monitoring Briefs with status and report URLs. Still-running Briefs are reconciled first. Requires a plan with Briefs access.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Authorization: Bearer gdelt_sk_...
The caller's Briefs.
Show child attributes