FMFrontlines Watchdesk
Sources

Source Catalog

Each provider is isolated behind its own adapter. The UI never calls upstream APIs directly.

Providers

6

Adapters with their own fetch, normalize, and health path.

Official or direct feeds

5

High-confidence providers prioritized ahead of broad discovery feeds.

Fastest refresh

5m

USGS and NWS are the fastest current intervals in this catalog.

Credentialed sources

2

Feeds that require API keys or user-agent identification.

Adapter contract

  • Every provider fetch runs server-side and is normalized into the same event schema before it reaches the UI.
  • Upstream failures are surfaced as source-health state; production adapters must not silently swap back to fixtures.
  • Licensing, auth expectations, and kill-switch controls are documented per provider before a source is allowed into the ingest loop.

Freshness semantics

  • Fresh: Last success is within 2x the expected interval.
  • Delayed: Last success is between 2x and 6x the expected interval.
  • Stale: Last success exceeded 6x the expected interval.
  • Down: Multiple consecutive failures have taken the source offline.
  • Disabled: Manual kill switch disabled this source.

GDELT

15m

Discovery feed for global conflict, protest, disaster, and infrastructure reporting.

  • Coverage: Global event discovery
  • Auth: none
  • Kill switch: SOURCE_GDELT_ENABLED
  • License note: Open discovery feed; review source licensing for downstream use.
View source documentation

GDACS

15m

UN/EU disaster awareness and coordination alerts for major hazards.

  • Coverage: Disaster alerts
  • Auth: none
  • Kill switch: SOURCE_GDACS_ENABLED
  • License note: Official public disaster awareness and coordination data.
View source documentation

USGS

5m

Programmatic GeoJSON feeds for recent earthquake events.

  • Coverage: Earthquakes
  • Auth: none
  • Kill switch: SOURCE_USGS_ENABLED
  • License note: Public USGS earthquake feed.
View source documentation

NASA FIRMS

30m

Near-real-time fire and hotspot detections from MODIS and VIIRS.

  • Coverage: Active fire detections
  • Auth: api-key
  • Kill switch: SOURCE_FIRMS_ENABLED
  • License note: NASA fire data with key-based web services for some endpoints.
View source documentation

NWS

5m

Open weather alerts, forecasts, and observations API for the United States.

  • Coverage: US weather alerts
  • Auth: user-agent
  • Kill switch: SOURCE_NWS_ENABLED
  • License note: Open US National Weather Service API; identify your client.
View source documentation

ReliefWeb

15m

Humanitarian reports and updates curated from thousands of sources.

  • Coverage: Humanitarian reports
  • Auth: none
  • Kill switch: SOURCE_RELIEFWEB_ENABLED
  • License note: API access with appname parameter and documented quotas.
View source documentation