Skip to content
HALOWERK

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-events

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
hoursintegerNoHow many hours of the newest 15-minute exports to scan.
countrystringNoFIPS 10-4 country code of the event location as used by GDELT (Germany = GM, France = FR, United States = US).
adm1stringNoGDELT ADM1 code of the event location, e.g. GM07.
actorstringNoSubstring of an actor name or exact actor code (CAMEO), case-insensitive.
event_root_codesarrayNoCAMEO root codes 01-20.
quad_classesarrayNo
url_keywordstringNoKeyword that must appear in the source URL (a rough topic filter).
events_tsvstringNoOptional GDELT 2.0 event export rows (tab-separated, 61 columns) to analyse instead of fetching.
max_eventsintegerNo
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
    }
  }
}

Open original schema

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

All endpoints in this hub โ†’