Skip to main content
GET
/
api
/
v1
/
cameoplus-events
List CAMEO+ Events
curl --request GET \
  --url https://gdeltcloud.com/api/v1/cameoplus-events \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "events": [
    {
      "id": "<string>",
      "cluster_id": "<string>",
      "event_date": "2023-12-25",
      "domain": "POLITICAL",
      "event_code": "EC02",
      "event_label": "Monetary Policy Action",
      "actor": "<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
  }
}

Authorizations

​
Authorization
string
header
required

API key format: gdelt_sk_<64-hex-chars>. Generate in Dashboard → Settings → API Keys.

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.

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

CAMEO+ event code (e.g. EC02, TE01, HE02, CO01). Must be a valid code for the given domain.

Example:

"EC02"

​
country
string

Full English country name where the event is most relevant (e.g. 'United States', 'Germany', 'China').

Example:

"United States"

​
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