World Monitor APIworldmonitor.app ↗
Access real-time conflict events, military posture, cyber threats, maritime GPS jamming, supply chain status, economic indicators, and more via the World Monitor API.
What is the World Monitor API?
The World Monitor API exposes 19 endpoints covering live geopolitical, economic, and environmental data from worldmonitor.app. A single bootstrap call returns bulk dashboard data across a dozen categories at once, while focused endpoints like conflict_events, military, maritime, and cyber_threats let you pull specific intelligence feeds. Response fields span ACLED armed conflict records, theater posture levels, GPS jamming hex regions, chokepoint disruption scores, and Polymarket prediction market odds.
curl -X GET 'https://api.parse.bot/scraper/5f4c6353-3b55-4f27-8a37-3d0429ad0915/bootstrap?tier=slow' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace worldmonitor-app-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: World Monitor Geopolitical Intelligence SDK — bounded, re-runnable."""
from parse_apis.world_monitor_geopolitical_intelligence_api import (
WorldMonitor, MarketType, ConflictSource, SupplyChainType, EconType, DataNotFound
)
client = WorldMonitor()
# List recent earthquakes globally from USGS — limit caps total items fetched.
for quake in client.earthquakes.list(limit=3):
print(quake.id, quake.magnitude, quake.location)
# Get market quotes for Gulf region stocks using a typed enum.
for quote in client.marketquotes.list(type=MarketType.GULF, limit=5):
print(quote.symbol, quote.price, quote.change)
# Drill-down: take ONE chokepoint and inspect its disruption level.
chokepoint = client.chokepoints.list(type=SupplyChainType.CHOKEPOINTS, limit=1).first()
if chokepoint:
print(chokepoint.name, chokepoint.status, chokepoint.disruptionScore)
# List conflict events from UCDP source.
for event in client.conflictevents.list(source=ConflictSource.UCDP, limit=3):
print(event.title, event.location, event.severity)
# Typed error handling around economic data retrieval.
try:
econ = client.economicdatas.get(type=EconType.ENERGY)
print(econ.prices)
except DataNotFound as exc:
print(f"economic data unavailable: {exc}")
print("exercised: earthquakes.list / marketquotes.list / chokepoints.list / conflictevents.list / economicdatas.get")
Get comprehensive dashboard data in bulk. Returns multiple categories at once: earthquakes, outages, service statuses, market quotes, commodity quotes, macro signals, chokepoints, sectors, ETF flows, BIS policy rates, exchange rates, shipping rates, minerals, climate anomalies, wildfires, cyber threats.
| Param | Type | Description |
|---|---|---|
| tier | string | Data tier: 'fast' (earthquakes, outages, services, market/commodity quotes, macro signals, chokepoints), 'slow' (sectors, ETF flows, BIS policy/exchange rates, shipping, minerals, climate, wildfires, cyber threats), or 'all' (both combined) |
{
"type": "object",
"fields": {
"data": "object containing all widget data keyed by category name"
},
"sample": {
"data": {
"data": {
"outages": [],
"earthquakes": [],
"serviceStatuses": []
}
},
"status": "success"
}
}About the World Monitor API
Conflict, Military, and Intelligence
The conflict_events endpoint accepts a source parameter to switch between datasets: acled for armed conflict, ucdp for conflict data, oref for Israel alert feeds, unrest for civil unrest filtered by min_severity, and humanitarian for per-country summaries keyed by country_code. The intelligence endpoint returns CII regional risk scores with combinedScore, trend, and component breakdowns, as well as DEFCON-style status objects. Pass type=country_brief with a country name to retrieve a targeted intelligence summary. The military endpoint covers theater_posture (active flights and tracked vessels per theater), US Navy fleet positions, and military bases.
Infrastructure, Climate, and Supply Chain
infrastructure splits into outages (internet disruption events with country, severity, and cause) and services (operational status for AWS, Azure, GCP, GitHub, and similar platforms). climate_weather returns either climate anomalies per zone — including tempDelta, precipDelta, and severity — or satellite wildfire detections. supply_chain covers maritime chokepoints (Suez, Hormuz, Malacca, Panama) with disruptionScore, congestionLevel, affectedRoutes, and warRiskTier, plus critical minerals market data.
Markets, Trade, and Economic Data
markets returns Gulf/Middle East equity quotes, cryptocurrency prices, or stablecoin data, all with price, change, and sparkline arrays. economic offers commodity/energy prices or BIS credit-to-GDP ratios by country with creditGdpRatio and date. trade returns recent restrictions and barriers — country, type, description, and date — filterable by type and limit. The maritime endpoint delivers GPS jamming and spoofing detections broken down by H3 hex grid regions worldwide.
News, Signals, and Events
news_feed aggregates categorized digests from CNN, BBC, Reuters, AP, Al Jazeera, and others, grouped into categories like middleeast, finance, ai, and energy. telegram_feed returns OSINT channel messages with channel, text, topic, and tags. prediction_markets pulls Polymarket data filterable by tag (politics, crypto, sports). research_tech lists upcoming conferences, earnings, product launches, and IPOs within a configurable days look-ahead window. displacement provides UNHCR-style global totals for refugees, asylum seekers, IDPs, and stateless persons, plus country-level arrays and top displacement flows.
The World Monitor API is a managed, monitored endpoint for worldmonitor.app — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when worldmonitor.app changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official worldmonitor.app API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Trigger supply chain alerts when a chokepoint's
disruptionScoreorwarRiskTiercrosses a threshold via thesupply_chainendpoint. - Build a live conflict dashboard by polling
conflict_eventswithsource=acledand overlaying results on a geographic map. - Monitor cloud infrastructure health by pulling
infrastructurewithtype=servicesto track AWS, Azure, and GCP operational status. - Correlate Gulf equity market movements from
marketswith geopolitical risk scores fromintelligencefor trading signal research. - Track global displacement trends using
displacementsummary totals andtopFlowsto support humanitarian logistics planning. - Aggregate OSINT early-warning signals from
telegram_feedalongsidenews_feedcategories for a unified analyst briefing feed. - Detect aviation disruption risk by combining
aviationdelay alerts withclimate_weatheranomaly severity for affected regions.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does worldmonitor.app offer an official developer API?+
What does the `conflict_events` endpoint distinguish between its source options?+
source=acled returns ACLED armed conflict records; source=ucdp returns UCDP conflict data; source=unrest returns civil unrest events filterable by min_severity; source=oref returns Israel OREF alert feeds selectable by oref_endpoint; and source=humanitarian returns per-country humanitarian summaries, which requires supplying a country_code such as SY.Does the `maritime` endpoint include vessel AIS tracking or port congestion data beyond GPS jamming?+
maritime endpoint returns GPS jamming and spoofing detections by H3 hex region. Vessel AIS positions and per-port congestion metrics are not part of the current response shape. You can fork this API on Parse and revise it to add those endpoints if your use case requires vessel-level tracking.How fresh is the data across endpoints, and is there historical data available?+
earthquakes, telegram_feed, and cyber_threats reflect live or recently ingested data. Historical time-series archives beyond what each upstream source exposes in its current feed are not available through these endpoints. You can fork this API on Parse and revise it to store responses and build your own historical layer.Does the `intelligence` endpoint include threat assessments for all countries?+
intelligence endpoint returns CII risk scores organized by region (not individual countries) when using type=risk_scores, and a country-level brief when using type=country_brief with a country name. Exhaustive coverage for every UN-recognized country is not guaranteed — availability depends on the upstream data sources feeding each region. You can fork this API on Parse and revise it to augment with additional country intelligence sources.