Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl --request GET \
--url https://gdeltcloud.com/api/v2/monitors/{id}/runs/{runId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/monitors/{id}/runs/{runId}"
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/monitors/{id}/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"monitor": {
"id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"organization_id": "88949d2a-4f00-45cb-9d23-2d242ddfe74d",
"created_by": "c6951b53-952b-40bf-99fd-c9d97a176f38",
"name": "Port disruption watch",
"description": "New coverage of port closures and shipping disruption in the United States.",
"enabled": true,
"subject": {
"type": "topic"
},
"criteria": {
"data": "events_and_stories",
"search": "port closure shipping disruption",
"countries": [
"USA"
],
"family_filters": {
"cameoplus": {
"domains": [
"INFRASTRUCTURE"
],
"subcategories": []
},
"story": {
"categories": [
"cameoplus_infrastructure"
]
}
},
"fatalities_only": false
},
"trigger": {
"type": "new_matches"
},
"schedule": {
"cadence": "hourly",
"timezone": "UTC",
"daily_hour": 8
},
"delivery": {
"email": true,
"webhook": {
"configured": true,
"endpoint": "https://example.com/gdelt-webhook",
"consecutive_failures": 0,
"last_success_at": "2026-08-23T14:05:00.000Z",
"last_failure_at": null
}
},
"created_at": "2026-08-23T13:00:00.000Z",
"updated_at": "2026-08-23T14:05:00.000Z",
"last_checked_at": "2026-08-23T14:00:00.000Z",
"last_triggered_at": "2026-08-23T14:00:00.000Z",
"legacy": false
},
"run": {
"id": "6d403a03-83a7-4603-a92d-37012fbf0219",
"execution_key": "monitor/5e1d3b89-9c34-4fa1-80fc-17f72f782b33/v1/2026-08-24T14:00:00.000Z",
"alert_rule_id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"alert_log_id": 412,
"shared_run_id": "7b1a1fac-f9dc-4667-b013-3de5ed4bf6fa",
"results": [
{
"item_id": "story:story_example",
"lane": "story",
"id": "story_example",
"title": "Port operations paused after labor disruption"
}
],
"result_count": 3,
"summary_json": {
"total_matches": 3,
"total_matches_is_lower_bound": false,
"candidate_limit": 100,
"retained_matches": 1,
"truncated": true,
"disposition": "triggered",
"reason": "3 new matches found in the current window.",
"frequency": "hourly",
"target_family": "cameoplus",
"selected_families": [
"cameoplus",
"conflict",
"story"
],
"window_start": "2026-08-24T13:00:00.000Z",
"window_end": "2026-08-24T14:00:00.000Z",
"window_label": "Previous completed UTC hour",
"family_groups": [
{
"label": "Story",
"count": 1
}
],
"country_groups": [
{
"label": "United States",
"count": 1
}
],
"signal_groups": [],
"top_items": [
{
"title": "Port operations paused after labor disruption",
"family": "story",
"meta": "United States",
"observed_at": "2026-08-24T13:42:00.000Z"
}
]
},
"ai_summary": null,
"retained_row_count": 1,
"truncated": true,
"evaluation_json": {
"would_trigger": true,
"disposition": "triggered",
"reason": "3 new matches found in the current window.",
"current_count": 3,
"baseline_average": null,
"event_count": null,
"story_count": null,
"event_baseline_average": null,
"story_baseline_average": null,
"new_item_ids": [
"story:story_example"
],
"trigger_fingerprint": "sha256:opaque"
},
"executed_at": "2026-08-24T14:00:04.000Z",
"viewed_at": null,
"expires_at": "2026-08-31T14:00:04.000Z",
"created_at": "2026-08-24T14:00:04.000Z",
"summary": {
"type": "new_matches",
"total_matches": 3,
"total_matches_is_lower_bound": false,
"candidate_limit": 100,
"included_matches": 1,
"truncated": true
},
"matches": [
{
"kind": "story",
"item": {
"id": "story_example",
"title": "Port operations paused after labor disruption"
}
}
],
"replay_requests": [
{
"method": "GET",
"endpoint": "/api/v2/stories",
"parameters": {
"observed_start": "2026-08-24",
"observed_end": "2026-08-25",
"limit": 100,
"search": "port closure shipping disruption",
"country": "USA"
},
"window": {
"start": "2026-08-24T13:00:00.000Z",
"end": "2026-08-24T14:00:00.000Z"
},
"exact_window_filter": {
"field": "updated_at",
"start_inclusive": "2026-08-24T13:00:00.000Z",
"end_exclusive": "2026-08-24T14:00:00.000Z"
},
"pagination": {
"cursor_response_field": "pagination.next_cursor",
"cursor_request_parameter": "cursor",
"stop_when": "next_cursor is null"
}
}
]
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Get one triggered run with bounded canonical matches and exact replay instructions. Follow every cursor and then apply exact_window_filter.
curl --request GET \
--url https://gdeltcloud.com/api/v2/monitors/{id}/runs/{runId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/monitors/{id}/runs/{runId}"
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/monitors/{id}/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"monitor": {
"id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"organization_id": "88949d2a-4f00-45cb-9d23-2d242ddfe74d",
"created_by": "c6951b53-952b-40bf-99fd-c9d97a176f38",
"name": "Port disruption watch",
"description": "New coverage of port closures and shipping disruption in the United States.",
"enabled": true,
"subject": {
"type": "topic"
},
"criteria": {
"data": "events_and_stories",
"search": "port closure shipping disruption",
"countries": [
"USA"
],
"family_filters": {
"cameoplus": {
"domains": [
"INFRASTRUCTURE"
],
"subcategories": []
},
"story": {
"categories": [
"cameoplus_infrastructure"
]
}
},
"fatalities_only": false
},
"trigger": {
"type": "new_matches"
},
"schedule": {
"cadence": "hourly",
"timezone": "UTC",
"daily_hour": 8
},
"delivery": {
"email": true,
"webhook": {
"configured": true,
"endpoint": "https://example.com/gdelt-webhook",
"consecutive_failures": 0,
"last_success_at": "2026-08-23T14:05:00.000Z",
"last_failure_at": null
}
},
"created_at": "2026-08-23T13:00:00.000Z",
"updated_at": "2026-08-23T14:05:00.000Z",
"last_checked_at": "2026-08-23T14:00:00.000Z",
"last_triggered_at": "2026-08-23T14:00:00.000Z",
"legacy": false
},
"run": {
"id": "6d403a03-83a7-4603-a92d-37012fbf0219",
"execution_key": "monitor/5e1d3b89-9c34-4fa1-80fc-17f72f782b33/v1/2026-08-24T14:00:00.000Z",
"alert_rule_id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
"alert_log_id": 412,
"shared_run_id": "7b1a1fac-f9dc-4667-b013-3de5ed4bf6fa",
"results": [
{
"item_id": "story:story_example",
"lane": "story",
"id": "story_example",
"title": "Port operations paused after labor disruption"
}
],
"result_count": 3,
"summary_json": {
"total_matches": 3,
"total_matches_is_lower_bound": false,
"candidate_limit": 100,
"retained_matches": 1,
"truncated": true,
"disposition": "triggered",
"reason": "3 new matches found in the current window.",
"frequency": "hourly",
"target_family": "cameoplus",
"selected_families": [
"cameoplus",
"conflict",
"story"
],
"window_start": "2026-08-24T13:00:00.000Z",
"window_end": "2026-08-24T14:00:00.000Z",
"window_label": "Previous completed UTC hour",
"family_groups": [
{
"label": "Story",
"count": 1
}
],
"country_groups": [
{
"label": "United States",
"count": 1
}
],
"signal_groups": [],
"top_items": [
{
"title": "Port operations paused after labor disruption",
"family": "story",
"meta": "United States",
"observed_at": "2026-08-24T13:42:00.000Z"
}
]
},
"ai_summary": null,
"retained_row_count": 1,
"truncated": true,
"evaluation_json": {
"would_trigger": true,
"disposition": "triggered",
"reason": "3 new matches found in the current window.",
"current_count": 3,
"baseline_average": null,
"event_count": null,
"story_count": null,
"event_baseline_average": null,
"story_baseline_average": null,
"new_item_ids": [
"story:story_example"
],
"trigger_fingerprint": "sha256:opaque"
},
"executed_at": "2026-08-24T14:00:04.000Z",
"viewed_at": null,
"expires_at": "2026-08-31T14:00:04.000Z",
"created_at": "2026-08-24T14:00:04.000Z",
"summary": {
"type": "new_matches",
"total_matches": 3,
"total_matches_is_lower_bound": false,
"candidate_limit": 100,
"included_matches": 1,
"truncated": true
},
"matches": [
{
"kind": "story",
"item": {
"id": "story_example",
"title": "Port operations paused after labor disruption"
}
}
],
"replay_requests": [
{
"method": "GET",
"endpoint": "/api/v2/stories",
"parameters": {
"observed_start": "2026-08-24",
"observed_end": "2026-08-25",
"limit": 100,
"search": "port closure shipping disruption",
"country": "USA"
},
"window": {
"start": "2026-08-24T13:00:00.000Z",
"end": "2026-08-24T14:00:00.000Z"
},
"exact_window_filter": {
"field": "updated_at",
"start_inclusive": "2026-08-24T13:00:00.000Z",
"end_exclusive": "2026-08-24T14:00:00.000Z"
},
"pagination": {
"cursor_response_field": "pagination.next_cursor",
"cursor_request_parameter": "cursor",
"stop_when": "next_cursor is null"
}
}
]
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
