Skip to main content

​
Event Taxonomy

The Intrace Corpus uses a comprehensive three-level taxonomy to classify all events: Category → Event Type → Subtype This hierarchical structure enables precise filtering and analysis across 8 major categories, 52 event types, and 248 specific subtypes.

​
Taxonomy Statistics

LevelCountDescription
Categories8Top-level classification domains
Event Types52Specific event classifications within categories
Subtypes248Granular event variations

​
Category Quick Reference

​
Conflict & Crisis

  • Icon: shield-alert
  • Color: #DC2626
  • Event Types: 5
  • Subtypes: 25
  • Special Fields: 5
View complete Conflict & Crisis taxonomy →

​
Crime & Justice

  • Icon: gavel
  • Color: #F59E0B
  • Event Types: 8
  • Subtypes: 35
  • Special Fields: 6
View complete Crime & Justice taxonomy →

​
Corporate & M&A

  • Icon: building-2
  • Color: #6366F1
  • Event Types: 7
  • Subtypes: 30
  • Special Fields: 7
View complete Corporate & M&A taxonomy →

​
Political & Policy

  • Icon: landmark
  • Color: #2563EB
  • Event Types: 8
  • Subtypes: 40
  • Special Fields: 4
View complete Political & Policy taxonomy →

​
Cyber & Threat Intel

  • Icon: shield-check
  • Color: #8B5CF6
  • Event Types: 5
  • Subtypes: 24
  • Special Fields: 7
View complete Cyber & Threat Intel taxonomy →

​
Climate & Environmental Crisis

  • Icon: cloud-rain
  • Color: #059669
  • Event Types: 7
  • Subtypes: 37
  • Special Fields: 6
View complete Climate & Environmental Crisis taxonomy →

​
Organized Crime & Non-Political Violence

  • Icon: skull
  • Color: #B91C1C
  • Event Types: 6
  • Subtypes: 28
  • Special Fields: 5
View complete Organized Crime & Non-Political Violence taxonomy →

​
Information Operations & Influence

  • Icon: radio-tower
  • Color: #D97706
  • Event Types: 6
  • Subtypes: 29
  • Special Fields: 5
View complete Information Operations & Influence taxonomy →

​
How to Use the Taxonomy

​
Filtering Events by Category

import requests

response = requests.get(
    "https://api.corpus.intrace.ai/v1/corpus/events",
    headers={"X-API-Key": "your-api-key"},
    params={"event_category": "conflict"}
)

​
Filtering by Type and Subtype

# Get all battles
response = requests.get(
    "https://api.corpus.intrace.ai/v1/corpus/events",
    headers={"X-API-Key": "your-api-key"},
    params={
        "event_category": "conflict",
        "event_type": "battles"
    }
)

​
Discovering Available Values

Use the metadata endpoints to discover all valid filter values: 
# Get all categories
categories = requests.get(
    "https://api.corpus.intrace.ai/v1/corpus/metadata/event-categories",
    headers={"X-API-Key": "your-api-key"}
).json()

# Get all types for a category
types = requests.get(
    "https://api.corpus.intrace.ai/v1/corpus/metadata/event-types",
    headers={"X-API-Key": "your-api-key"},
    params={"category": "conflict"}
).json()

​
Conceptual Framework

The taxonomy follows these principles:
  1. Category - The broadest classification, representing the domain or context
  2. Event Type - The specific nature of what happened
  3. Subtype - Precise variation or method
Example hierarchy:
  • Category: Cyber & Threat Intel
    • Type: Cyber Attack
      • Subtype: Ransomware
This structure allows for both broad analysis (“show me all cyber events”) and precise filtering (“show me only ransomware attacks on the financial sector”).

​
Next Steps

  • Explore detailed category pages to understand all types and subtypes
  • Review Actor Types to understand actor classification
  • See Data Models for complete field structures
  • Check the Integration Guide for code examples