Skip to main content

​
Overview

get_cameoplus_events returns structured event records across nine universal domains derived from GDELT news clusters. Each event is coded using CAMEO+ — GDELT Cloud’s extension of the CAMEO framework — covering economic, corporate, technology, infrastructure, environmental, health, demographic, information, and political events that traditional conflict-focused coding systems cannot capture. Every event links back to its source media event cluster via cluster_id and carries four latent event attributes (magnitude, systemic importance, propagation potential, market sensitivity) that require AI reasoning to produce.

​
Parameters

ParameterTypeDefaultDescription
daysinteger1Lookback window in days from date. Max 30.
datestringtoday UTCAnchor/end date in YYYY-MM-DD format.
limitinteger20Events to return (max 100).
offsetinteger0Pagination offset.
domainenum—CAMEO+ domain. See domain values below.
event_codestring—CAMEO+ event code (e.g. EC02, TE01, HE02). Must be valid for the given domain.
countrystring—Full English country name where the event is most relevant (e.g. 'United States', 'Germany').
min_magnitudenumber—Minimum magnitude score (0–10).
min_systemic_importancenumber—Minimum systemic importance (0–1).
min_market_sensitivitynumber—Minimum market sensitivity (0–1).
searchstring—Natural-language semantic search query. Ranks results by cosine similarity to the event’s AI-generated description instead of chronological order. Fully combinable with all other filters.

​
Domain Values

ValueDescription
POLITICALDiplomatic, cooperative, and non-violent coercive political events (CAMEO 01–17)
ECONOMICMacroeconomic indicators, monetary policy, fiscal policy, trade, market stress events
CORPORATEM&A, bankruptcies, production capacity, technology milestones, capital allocation
TECHNOLOGYAI capability, military technology, cyber operations, space, strategic tech controls
INFRASTRUCTUREEnergy, transport, supply chain, communications infrastructure disruptions
ENVIRONMENTGeophysical hazards, meteorological events, climate events, pollution
HEALTHDisease outbreaks, pandemics, vaccines, health policy, health system crises
DEMOGRAPHICRefugee flows, migration, population crises, labor events
INFORMATIONDisinformation campaigns, information controls, major leaks, narrative warfare

​
Event Codes by Domain

CodeEvent
EC01Macroeconomic Indicator Release
EC02Monetary Policy Action
EC03Fiscal Policy Action
EC04Trade Policy Action
EC05Market Stress Event
EC06Currency Event
EC07Sovereign Debt Event
CodeEvent
CO01Merger or Acquisition
CO02Bankruptcy or Restructuring
CO03Production Capacity Change
CO04Technology Development Milestone
CO05Capital Allocation Event
CO06Regulatory or Legal Action
CO07Leadership or Governance Change
CO08Supply Chain Shock
CodeEvent
TE01AI Capability Event
TE02Military Technology Event
TE03Cyber Event
TE04Space or Satellite Event
TE05Strategic Technology Control
TE06Critical Tech Infrastructure
CodeEvent
IN01Energy Infrastructure Event
IN02Transport Disruption
IN03Supply Chain Disruption
IN04Communications Infrastructure
IN05Deliberate Infrastructure Sabotage
IN06Water Infrastructure Event
CodeEvent
EN01Geophysical Hazard
EN02Meteorological Hazard
EN03Climate Event
EN04Environmental Pollution Event
EN05Environmental Policy or Agreement
CodeEvent
HE01Disease Outbreak
HE02Pandemic or Global Health Emergency
HE03Vaccine or Treatment Milestone
HE04Public Health Policy Action
HE05Health System Crisis
CodeEvent
DE01Mass Displacement or Refugee Event
DE02Migration Event
DE03Population Crisis
DE04Labor Event
DE05Urbanization or Housing Event
CodeEvent
IF01Disinformation or Influence Operation
IF02Information Control Action
IF03Major Leak or Disclosure
IF04Narrative Warfare Event
Uses standard CAMEO 2–4 digit codes for diplomatic/political interactions: 01 Make public statement, 02–03 Appeal/Express intent, 04 Consult, 05 Diplomatic cooperation, 06–07 Material cooperation/Aid, 08 Yield, 09 Investigate, 10–12 Demand/Disapprove/Reject, 13 Threaten, 15 Exhibit force posture, 16–17 Reduce relations/Coerce.

​
Data Structure

Each returned event contains: 
{
  "id": "uuid",
  "cluster_id": "...",           // links to media event cluster
  "event_date": "2026-07-01",
  "domain": "ECONOMIC",
  "event_code": "EC02",
  "event_label": "Monetary Policy Action",
  "actor": "Federal Reserve",
  "country": "United States",
  "location": "Washington",
  "latitude": 38.895,
  "longitude": -77.037,
  "description": "The Federal Reserve raised the federal funds rate by 25 basis points...",
  "magnitude": 6.0,
  "systemic_importance": 0.85,
  "propagation_potential": 0.72,
  "market_sensitivity": 0.91,
  "confidence": 0.94,
  "source_urls": ["https://..."]
}

​
Latent Event Attributes

AttributeRangeDescription
magnitude0–10Domain-specific intensity. For ECONOMIC: routine rate adjustments = 3–4, sovereign defaults = 9–10. For ENVIRONMENT: calibrated to scientific scales (Mw, hurricane category). For HEALTH: 1–3 = local, 7–10 = global emergency.
systemic_importance0–1How much this event affects the broader system — e.g., a major bank failure scores high; a local product recall scores low.
propagation_potential0–1Likelihood of cascading or contagion effects — e.g., a WHO pandemic declaration scores high; a regional drought scores lower.
market_sensitivity0–1Expected financial market impact — e.g., a central bank rate decision or trade tariff announcement scores high; a cultural event scores low.

​
Usage Patterns

​
Domain-first exploration

1. get_cameoplus_events(days=7, domain='ECONOMIC')
   → Returns economic events from the past week

2. Narrow by code: event_code='EC02'
   → Shows only monetary policy actions

3. Drill into source: get_media_event_cluster(cluster_id=...)
   → Full news coverage for that specific event

​
High-impact event screening

get_cameoplus_events(
    days=7,
    min_magnitude=7,
    min_systemic_importance=0.7
)
→ Surfaces major structural events across all domains

​
Example queries

get_cameoplus_events(
    days=7,
    domain="ECONOMIC",
    event_code="EC02"
)

​
Common Use Cases

  • “What economic policy events happened this week?” → domain='ECONOMIC', days=7
  • “Show me AI capability announcements in the past month” → domain='TECHNOLOGY', event_code='TE01', days=30
  • “Find high market-sensitivity events” → min_market_sensitivity=0.8, days=7
  • “What cyber incidents occurred in the US?” → domain='TECHNOLOGY', event_code='TE03', country='United States'
  • “Show pandemics and global health emergencies” → domain='HEALTH', event_code='HE02'
  • “Find events about trade tariffs and export controls” → search='trade tariffs export controls', days=30
  • “What major corporate restructurings happened?” → domain='CORPORATE', event_code='CO02', days=30
  • “Show events with high systemic importance” → min_systemic_importance=0.8, days=14

get_media_events

Discover news story clusters — use to find stories related to CAMEO+ events

get_media_event_cluster

Deep-dive into a cluster using the cluster_id from CAMEO+ event results

get_conflict_events

ACLED-coded conflict events — the companion to CAMEO+ for violence and protest

​
CAMEO+ Methodology

CAMEO+ events are independently generated by GDELT Cloud from news media clusters. Each cluster is evaluated to determine whether it contains a discrete, in-scope event, and if so, which domain and event code applies. Only enacted or confirmed events are coded — not proposals, analysis, commentary, or general coverage. The magnitude, systemic_importance, propagation_potential, and market_sensitivity attributes are AI-derived scores that require contextual reasoning to produce and cannot be derived from rule-based systems. See the Event Coding feature guide for the full taxonomy and domain descriptions.