Datenwerk
gdelt events
Reads the 15-minute GDELT 2.0 event exports (data.gdeltproject.org, zipped TSV, cached per file) for the requested hours, or rows you supply, and filters by action location (FIPS country code, ADM1 code), actor name or code, CAMEO root event codes, quad class and a keyword in the source URL. Returns the number of matching events, mean/median tone (AvgTone), mean Goldstein scale, counts per CAMEO root category and quad class, top locations and source domains, and sample events with source.
POST https://daten.halowerk.com/v1/gdelt-eventsInputs
| Field | Type | Required | Description |
|---|---|---|---|
| hours | integer | No | How many hours of the newest 15-minute exports to scan. |
| country | string | No | FIPS 10-4 country code of the event location as used by GDELT (Germany = GM, France = FR, United States = US). |
| adm1 | string | No | GDELT ADM1 code of the event location, e.g. GM07. |
| actor | string | No | Substring of an actor name or exact actor code (CAMEO), case-insensitive. |
| event_root_codes | array | No | CAMEO root codes 01-20. |
| quad_classes | array | No | |
| url_keyword | string | No | Keyword that must appear in the source URL (a rough topic filter). |
| events_tsv | string | No | Optional GDELT 2.0 event export rows (tab-separated, 61 columns) to analyse instead of fetching. |
| max_events | integer | No |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"hours": {
"type": "integer",
"minimum": 1,
"maximum": 6,
"default": 2,
"description": "How many hours of the newest 15-minute exports to scan."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "FIPS 10-4 country code of the event location as used by GDELT (Germany = GM, France = FR, United States = US)."
},
"adm1": {
"type": "string",
"pattern": "^[A-Z]{2}[A-Z0-9]{2}$",
"description": "GDELT ADM1 code of the event location, e.g. GM07."
},
"actor": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Substring of an actor name or exact actor code (CAMEO), case-insensitive."
},
"event_root_codes": {
"type": "array",
"maxItems": 20,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09"
]
},
"description": "CAMEO root codes 01-20."
},
"quad_classes": {
"type": "array",
"maxItems": 4,
"uniqueItems": true,
"items": {
"type": "integer",
"enum": [
1,
2,
3,
4
]
}
},
"url_keyword": {
"type": "string",
"minLength": 3,
"maxLength": 60,
"description": "Keyword that must appear in the source URL (a rough topic filter)."
},
"events_tsv": {
"type": "string",
"maxLength": 1000000,
"description": "Optional GDELT 2.0 event export rows (tab-separated, 61 columns) to analyse instead of fetching."
},
"max_events": {
"type": "integer",
"minimum": 0,
"maximum": 200,
"default": 25
}
}
}Published input example
{
"hours": 2,
"country": "GM",
"max_events": 10
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Datenwerk0.002 USDC
agenda timebox
POSThttps://daten.halowerk.com/v1/agenda-timeboxItems are scheduled in the given order from the start time, with an optional buffer between items and a break inserted after the item that reaches the break interval. If a total length is set and the plan is too long, overflow=compress shor
- Datenwerk0.003 USDC
approval quorum
POSThttps://daten.halowerk.com/v1/approval-quorumCreates three separate role links for one immutable proposal and action SHA-256. Two approved links yield approved; two rejected links yield rejected. Otherwise the round stays pending until expiry. POST quorum_id and access_token to status
- Datenwerk0.003 USDC
bank csv unify
POSThttps://daten.halowerk.com/v1/bank-csv-unifyNo bank-specific layouts are assumed: the header row (preamble lines before it are skipped) is matched against a documented list of German and English column terms (Buchungstag, Valuta/Wertstellung, Betrag/Umsatz, Soll/Haben, Auftraggeber/E