GeoStability

GeoStability API – Unified Real-Time Crisis Events

Query ACLED, GDELT, USGS, GDACS + clustering/confidence in one endpoint. Free tier available.

Features

Mixed disasters & conflicts

One API for ACLED, GDELT, USGS, GDACS and more. Armed conflict, natural disasters, and humanitarian events in a single query.

Confidence scoring

Every event includes confidence level and scoring so you can filter by reliability and prioritize high-signal data.

Basic geo filter

Filter by country code or lat/lon + radius (km). Build maps, regional dashboards, or location-based alerts.

See It Live – Recent Crisis Events on Map

Recent published events with coordinates (sample). Click markers for details.

Loading events…

Pricing

Free

$0

500 calls/mo

Pro

$9/mo

Unlimited basic

Enterprise

Contact

Bulk & custom

What's happening right now – sample from the API

Recent Events – Live Sample (refreshes every 5 min)

Political TensionMedium

MIAMI / PROSECUTOR / -5.0

Mar 13 · Location data loading – check API for full coordinates

MIAMI / PROSECUTOR / -5.0

Source count: 1

Political TensionMedium

MIAMI / PERU / 7.0

Mar 13 · Location data loading – check API for full coordinates

MIAMI / PERU / 7.0

Source count: 1

Political TensionMedium

MIAMI / 7.0

Mar 13 · Location data loading – check API for full coordinates

MIAMI / 7.0

Source count: 1

Political TensionMedium

MIAMI / -5.0

Mar 13 · Location data loading – check API for full coordinates

MIAMI / -5.0

Source count: 1

Political TensionMedium

IOWA / 0.0

Mar 13 · Location data loading – check API for full coordinates

IOWA / 0.0

Source count: 1

Political TensionMedium

CRIMINAL / -5.0

Mar 13 · Location data loading – check API for full coordinates

CRIMINAL / -5.0

Source count: 1

Political TensionMedium

IOWA / 0.0

Mar 13 · Location data loading – check API for full coordinates

IOWA / 0.0

Source count: 1

Political TensionMedium

MIAMI / PERU / -5.0

Mar 13 · Location data loading – check API for full coordinates

MIAMI / PERU / -5.0

Source count: 1

API reference

Events

Sign in, generate an API key, then call the events endpoint. Each event includes summary (the "why" explanation). Anonymous requests are rate-limited; use a key for your free tier quota.

curl 'https://geostability.com/api/events?limit=10'

Sample response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Armed clash in region X",
      "category": "Armed Conflict",
      "subtype": "Armed clash",
      "severity": "High",
      "confidence": "Medium",
      "occurred_at": "2025-03-10T14:00:00.000Z",
      "lat": 50.45,
      "lon": 30.52,
      "sources": [
        "https://example.com/source1"
      ],
      "feed_key": "gdelt_events",
      "summary": "Multiple corroborating reports of missile strike from Ukrainian and international media. High confidence due to ACLED verification."
    }
  ],
  "total": 1,
  "returned": 1
}

Params: category, country, since/until, lat, lon, radius_km, limit (default 20, max 100), offset. Optional: X-API-Key for quota.

Clusters (heat-map aggregation)

GET /api/clusters — aggregated buckets for heat-map or embed use. Published events only.

Params: timeline=7d|30d, resolution=coarse|medium|fine, category (optional).

Response: array of { lat, lon, count, avg_confidence, dominant_category, events_sample } (events_sample = up to 3 event ids).

Ready to build? Create an account and generate your API key.

Sign up / Log in