# US-Iran War Tracker

> Real-time intelligence dashboard tracking the US-Iran military conflict.
> Aggregates 15+ verified sources with trust-tier provenance (A=Official Government, B=Established Media, C=Social/OSINT).
> All data is available via JSON API routes. No authentication required. Updated every 30-300 seconds depending on source.

## API Endpoints

- [News Feed](https://us-iran-war.com/api/news): Aggregated RSS (BBC, Al Jazeera, Breaking Defense, War Zone, NPR) + GDELT articles, keyword-filtered for Middle East conflict. Updates every 60s. Returns NewsItem[] with trust tier, source, and timestamps.
- [Government Statements](https://us-iran-war.com/api/government): Official releases from DoD, CENTCOM, and State Department. Trust Tier A. Updates every 120s.
- [GDELT Geo Points](https://us-iran-war.com/api/gdelt/geo): Geolocated event markers from GDELT Project covering Iran, Iraq, Syria, and the Persian Gulf. Returns lat/lng/name/tone/source. Updates every 120s.
- [GDELT Timeline](https://us-iran-war.com/api/gdelt/timeline): 7-day article volume trend data for conflict-related coverage. Returns date/volume pairs. Updates every 300s.
- [Flight Tracking](https://us-iran-war.com/api/flights): OpenSky Network data for Middle East airspace (bounding box: 23-40°N, 42-65°E). Returns callsign, origin country, altitude, velocity, heading. Updates every 30s.
- [Threat Level](https://us-iran-war.com/api/threat-level): Algorithmic threat assessment on a 1-5 scale (LOW/GUARDED/ELEVATED/HIGH/CRITICAL) derived from article volume and keyword severity analysis. Updates every 60s.

## Data Model

- [Trust Tiers](https://us-iran-war.com/llms-full.txt): A = Official government sources (DoD, CENTCOM, State Dept, USGS, NASA). B = Established media (BBC, Al Jazeera, NPR, GDELT). C = Social media and unverified OSINT. Tier C items are quarantined with "unverified" badge until corroborated.
- [Event Schema](https://us-iran-war.com/llms-full.txt): Each event has: id, title, description, source, sourceId, trustTier (A/B/C), publishedAt (ISO 8601), url, and optional geo coordinates.

## Source Coverage

- [RSS Feeds](https://us-iran-war.com/llms-full.txt): BBC World, Al Jazeera, Breaking Defense, The War Zone, NPR, DoD Press, CENTCOM, State Department
- [Satellite Data](https://us-iran-war.com/llms-full.txt): USGS (seismic data)
- [Aviation](https://us-iran-war.com/llms-full.txt): OpenSky Network (ADS-B flight tracking)
- [Event Intelligence](https://us-iran-war.com/llms-full.txt): GDELT Project (articles, geolocation, timeline volume)

## Optional

- [Full Documentation](https://us-iran-war.com/llms-full.txt): Complete technical documentation including API response schemas, data refresh rates, and trust tier definitions