Skip to main content
GET
/
api
/
v1
/
cameoplus-events
List CAMEO+ Events
curl --request GET \
  --url http://localhost:3000/api/api/v1/cameoplus-events
{
  "success": true,
  "events": [
    {
      "id": "<string>",
      "cluster_id": "<string>",
      "story_url": "<string>",
      "event_date": "2023-12-25",
      "domain": "POLITICAL",
      "event_code": "EC02",
      "event_label": "Monetary Policy Action",
      "actor": "<string>",
      "region": "<string>",
      "country": "<string>",
      "location": "<string>",
      "latitude": 123,
      "longitude": 123,
      "description": "<string>",
      "magnitude": 123,
      "systemic_importance": 123,
      "propagation_potential": 123,
      "market_sensitivity": 123,
      "confidence": 123,
      "source_urls": [
        "<string>"
      ]
    }
  ],
  "metadata": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "execution_time_ms": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
days
integer
default:1

Lookback window in days from date. Default 1 = today only.

Required range: 1 <= x <= 30
​
date
string<date>

Anchor/end date (YYYY-MM-DD). Defaults to today UTC.

Example:

"2026-07-03"

​
limit
integer
default:20

Number of events to return (max 100). Default 20.

Required range: 1 <= x <= 100
​
offset
integer
default:0

Pagination offset.

Required range: x >= 0
​
domain
enum<string>

Filter by CAMEO+ domain. Accepts a single value or a comma-separated list (e.g. 'ECONOMIC,POLITICAL'). Case-insensitive.

Available options:
POLITICAL,
ECONOMIC,
CORPORATE,
TECHNOLOGY,
INFRASTRUCTURE,
ENVIRONMENT,
HEALTH,
DEMOGRAPHIC,
INFORMATION
​
event_code
string

CAMEO+ event code. Supports exact code matching (e.g. 'EC02') or domain-prefix matching (e.g. 'EC' matches all ECONOMIC codes). Codes by domain — ECONOMIC: EC01 Macroeconomic Indicator Release, EC02 Monetary Policy Action, EC03 Fiscal Policy Action, EC04 Trade Policy Action, EC05 Market Stress Event, EC06 Currency Event, EC07 Sovereign Debt Event. CORPORATE: CO01 Merger or Acquisition, CO02 Bankruptcy or Restructuring, CO03 Production Capacity Change, CO04 Technology Development Milestone, CO05 Capital Allocation Event, CO06 Regulatory or Legal Action, CO07 Leadership or Governance Change, CO08 Supply Chain Shock. TECHNOLOGY: TE01 AI Capability Event, TE02 Military Technology Event, TE03 Cyber Event, TE04 Space or Satellite Event, TE05 Strategic Technology Control, TE06 Critical Tech Infrastructure. INFRASTRUCTURE: IN01 Energy Infrastructure Event, IN02 Transport Disruption, IN03 Supply Chain Disruption, IN04 Communications Infrastructure, IN05 Deliberate Infrastructure Sabotage, IN06 Water Infrastructure Event. ENVIRONMENT: EN01 Geophysical Hazard, EN02 Meteorological Hazard, EN03 Climate Event, EN04 Environmental Pollution Event, EN05 Environmental Policy or Agreement. HEALTH: HE01 Disease Outbreak, HE02 Pandemic or Global Health Emergency, HE03 Vaccine or Treatment Milestone, HE04 Public Health Policy Action, HE05 Health System Crisis. DEMOGRAPHIC: DE01 Mass Displacement or Refugee Event, DE02 Migration Event, DE03 Population Crisis, DE04 Labor Event, DE05 Urbanization or Housing Event. INFORMATION: IF01 Disinformation or Influence Operation, IF02 Information Control Action, IF03 Major Leak or Disclosure, IF04 Narrative Warfare Event. POLITICAL: Standard CAMEO 2-digit codes 01–17 (e.g. '13'=Threaten, '14'=Protest/Demand, '17'=Coerce).

Example:

"EC02"

​
country
string

ISO-3 / CAMEO-3 country code where the event is most relevant (e.g. 'USA', 'DEU', 'CHN', 'GBR'). The field is stored as an ISO-3 code, so full country names like 'United States' will not match — use 'USA' instead. Accepts a single value or a comma-separated list (e.g. 'USA,GBR,DEU').

Example:

"USA"

​
region
enum<string>

Filter to a geographic region. Filters directly on the region column. Only one region may be specified per request.

Available options:
Middle East,
Northern Africa,
Western Africa,
Eastern Africa,
Middle Africa,
Southern Africa,
Europe,
South Asia,
Southeast Asia,
East Asia,
Central Asia,
North America,
Central America,
Caribbean,
South America,
Oceania
​
min_magnitude
number

Minimum magnitude score (0–10). Domain-specific intensity scale.

Required range: 0 <= x <= 10
Example:

6

​
min_systemic_importance
number

Minimum systemic importance (0–1). How much this event affects the broader system.

Required range: 0 <= x <= 1
Example:

0.7

​
min_market_sensitivity
number

Minimum market sensitivity (0–1). Expected financial market impact.

Required range: 0 <= x <= 1
Example:

0.8

​
search
string

Natural-language semantic search query. When provided, results are ranked by embedding cosine similarity instead of chronological order. Fully combinable with all other filters. Examples: 'central bank interest rate inflation', 'AI model capability release', 'hurricane disaster relief', 'trade tariff export controls'.

Example:

"central bank interest rate inflation"

Response

Success

​
success
boolean
​
events
object[]
​
metadata
object