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…

View Full Map

Pricing

Free

500 calls/mo

Get API key

Pro

$9/mo

Unlimited basic

Coming soon

Enterprise

Contact

Bulk & custom

What's happening right now – sample from the API

Recent Events – Live Sample (refreshes every 5 min)

No published events yet. Run ingestion or seed to see live samples here.

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.