Developer API

WorldImpulse API

Access real-time anomaly intelligence and event data from global aviation and maritime signals.

Endpoints

GET /api/anomalies

Returns the latest detected anomalies across all datasets. Supports filtering by dataset, time window, and minimum severity.

Parameter	Type	Description
datasets	string	Comma-separated: aviation, marine, tanker, cross, foc, … (default: all)
hours	number	Time window in hours, max 168 (default: 24)
min_severity	number	Minimum σ threshold (default: 12.0)
limit	number	Max results, max 500 (default: 300)

{
  "count": 42,
  "anomalies": [
    {
      "timestamp":    "2026-03-18T14:22:00.000Z",
      "dataset":       "marine",
      "cell_key":      "212_26",
      "lat":           26.5,
      "lng":           56.2,
      "anomaly_type":  "traffic_spike",
      "severity":      18.4,
      "details": {
        "count":          24,
        "historical_mean": 3.1
      }
    }
  ]
}

GET /api/anomaly-context/:cellKey

Returns OSINT analysis, LLM-generated story, and news articles for a specific anomaly cell.

Parameter	Type	Description
cellKey (path)	string	Cell identifier, e.g. `212_26`
dataset (query)	string	Optional: filter by dataset

{
  "cell_key":   "212_26",
  "dataset":    "marine",
  "geo": {
    "country":     "Iran",
    "region":      "Hormuz Strait",
    "displayName": "Hormuz Strait, Iran"
  },
  "story": {
    "en": "On March 18, a cluster of 24 tankers was detected...",
    "uk": "18 березня біля Ормузької протоки..."
  },
  "investigation_report": {
    "profile":      "tanker_cluster",
    "confidence":   82,
    "assessmentEn": "High concentration of tankers suggests..."
  },
  "articles": [
    {
      "title":     "Iran tensions rise near Hormuz",
      "source":    "Reuters",
      "url":       "https://reuters.com/...",
      "published": "2026-03-18"
    }
  ]
}

GET /api/event/:slug

Returns a single event by its URL slug. Combines anomaly data with full context (story, OSINT, articles). Slug format: {dataset}-{type}-{x}-{y}-{YYYYMMDD}

{
  "anomaly": { "cell_key": "212_26", "severity": 18.4, … },
  "context": { "story": { "en": "…" }, "investigation_report": { … }, … }
}

Use Cases

📊

Trading signals

Detect tanker route changes and port congestion before commodity price moves.

🔍

OSINT research

Monitor military aviation patterns, shadow fleet behavior, and sanctions evasion signals.

🚚

Supply chain

Get early warnings about port disruptions and shipping lane anomalies.

🗺️

Geopolitical intel

Correlate transport signals with breaking news to identify emerging situations.

Get API Access

The public endpoints above are available for exploration. For higher rate limits, historical data, and dedicated support — see our pricing plans.

View Pricing →