Tools (4)

search_crises
get_active_crises
list_crisis_sources
report_feedback

search_crises

Search for crises combining GDACS disaster alerts, USGS earthquakes, NOAA weather alerts, and GDELT news.

Returns structured disaster events, seismic data, active weather alerts, and
related news articles from global media. All eight sources are queried in parallel
for fast response.

Sources:
- GDACS: UN/EU disaster alerts (earthquakes, floods, cyclones, volcanoes, droughts, wildfires)
- USGS: Real-time seismic events with magnitude, depth, and location
- NOAA NWS: Active US weather alerts (severe storms, floods, fire weather)
- NVE: Norwegian flood warnings with regional activity levels
- SMHI: Swedish weather warnings (fire risk, storms, floods, extreme weather)
- DMI: Danish weather warnings (storms, rain, wind, snow, fog, ice)
- FMI: Finnish weather warnings via MeteoAlarm (fire risk, storms, wind, rain, flooding)
- GDELT: Global news media coverage and sentiment

Examples:
search_crises(query="earthquake")
search_crises(query="flood", country="Bangladesh", alert_levels="Orange,Red")
search_crises(query="wildfire California", event_types="WF", news_timespan="24h")

Parameter	Type	Required	Description
`query`	`string`	required	Search term — crisis type, country, or topic (e.g. 'earthquake Turkey', 'flood Bangladesh').
`from_date`	`string`	optional	Start date (YYYY-MM-DD). Defaults to 90 days ago. (default: "")
`to_date`	`string`	optional	End date (YYYY-MM-DD). Defaults to today. (default: "")
`event_types`	`string`	optional	Comma-separated: EQ (earthquake), TC (tropical cyclone), FL (flood), VO (volcano), DR (drought), WF (wildfire). (default: "")
`alert_levels`	`string`	optional	Comma-separated: Green, Orange, Red. (default: "")
`country`	`any`	optional	Filter by country name.
`news_timespan`	`string`	optional	GDELT news lookback: 24h, 7d, 1m. (default: "7d")
`max_events`	`integer`	optional	Max disaster events. (default: 25)
`max_articles`	`integer`	optional	Max news articles. (default: 10)
`min_magnitude`	`number`	optional	Minimum earthquake magnitude for USGS data. (default: 4.5)
`max_earthquakes`	`integer`	optional	Max USGS earthquake results. (default: 10)
`max_weather_alerts`	`integer`	optional	Max NOAA weather alerts. (default: 10)
`max_flood_warnings`	`integer`	optional	Max NVE flood warnings (Norway). (default: 10)
`max_smhi_warnings`	`integer`	optional	Max SMHI weather warnings (Sweden). (default: 10)
`max_dmi_warnings`	`integer`	optional	Max DMI weather warnings (Denmark). (default: 10)
`max_fmi_warnings`	`integer`	optional	Max FMI weather warnings (Finland). (default: 10)

Request Body

{
  "query": "NO"
}

get_active_crises

Get currently active disaster events worldwide from GDACS.

Returns ongoing crises from the last 90 days. Defaults to Orange and Red
alert levels — the most significant events requiring attention.

Event types:
- EQ: Earthquake
- TC: Tropical Cyclone
- FL: Flood
- VO: Volcano
- DR: Drought
- WF: Wildfire

Examples:
get_active_crises()
get_active_crises(alert_levels="Red")
get_active_crises(event_types="EQ,VO", country="Japan")

Parameter	Type	Required	Description
`event_types`	`string`	optional	Comma-separated: EQ, TC, FL, VO, DR, WF. Empty = all types. (default: "")
`alert_levels`	`string`	optional	Comma-separated: Green, Orange, Red. Default: Orange,Red. (default: "")
`country`	`any`	optional	Filter by country name.
`limit`	`integer`	optional	Max events to return. (default: 50)

Request Body

{
  "query": "example"
}

list_crisis_sources

List all crisis intelligence data sources and their coverage.

Shows which disaster monitoring systems and news sources are queried
during crisis searches.

Examples:
list_crisis_sources()

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/crisis-intelligence/search_crises" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/crisis-intelligence/search_crises",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())