# Hantatracker

> Real-time global Hantavirus surveillance dashboard. Tracks confirmed cases, outbreaks, deaths and case fatality rate per country, with live news ingestion from WHO Disease Outbreak News, the U.S. CDC, and international news sources. Updated every six hours.

URL: https://hantatracker.io
Operator: Raffaello Angelis
Contact: hello@hantatracker.io
License: Dataset under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)

## Data principles

- **Authoritative-source-only for case counts.** Case rows are only created from URLs matching WHO, CDC, PAHO, ECDC, KDCA, Rospotrebnadzor, THL, RKI, or national health-ministry domains. News outlets re-reporting an outbreak don't add cases — they add news.
- **Currently confirmed only.** Stats reflect active confirmed clusters, not multi-year cumulative figures. As of May 2026 the only active cluster is the MV Hondius outbreak (Andes virus, 11 confirmed cases across Argentina and Spain, 3 deaths). Numbers update as new authoritative reports land.
- **Time-stamped.** Every case row carries a `reported_at` and links to the source URL. Every news row carries `published_at` plus the original article URL.
- **Not medical advice.** Information service for the public, journalists and researchers. Symptoms after rodent exposure → contact a healthcare provider or your national health authority.

## Site map

- Dashboard: https://hantatracker.io/
- Methodology: https://hantatracker.io/about
- Country index (26 documented countries): https://hantatracker.io/country
  - Per-country pages: /country/{slug} for argentina, austria, belgium, bolivia, bosnia-and-herzegovina, brazil, canada, chile, china, croatia, czech-republic, finland, france, germany, india, japan, netherlands, norway, panama, paraguay, russia, slovenia, south-korea, sweden, united-kingdom, united-states, uruguay
- Privacy: https://hantatracker.io/privacy
- Terms: https://hantatracker.io/terms

## Public APIs (CC-BY 4.0 dataset)

- `GET /api/stats` — totals (current confirmed, deaths, CFR, countries with active cases, active outbreaks)
- `GET /api/map` — GeoJSON FeatureCollection of cases + outbreaks + news pins, plus country density map
- `GET /api/cases?since=Nd` — case rows reported in the last N days (1–365)
- `GET /api/news?limit=50` — most recent approved news articles
- `GET /api/region/[iso]` — country drilldown (totals, severity mix, regions, recent news, outbreaks)
- `GET /api/history?days=N` — daily case-count timeseries

All responses: `application/json` with shape `{ data, cached, updated_at }`. Free of charge, no key, rate-limited at the Cloudflare edge.

## Hantavirus reference (entity disambiguation for AI retrieval)

Hantavirus (genus Orthohantavirus, family Hantaviridae) is a rodent-borne RNA virus that causes:
- **Hantavirus pulmonary syndrome (HPS)** — Sin Nombre virus (USA), Andes virus (Argentina, Chile), Choclo virus (Panama), Araraquara virus (Brazil). Case fatality rate 30–40%. Acute respiratory failure 1–8 weeks after exposure. ICD-10: A98.5.
- **Haemorrhagic fever with renal syndrome (HFRS)** — Hantaan virus (China, Korea), Seoul virus (worldwide urban rats), Puumala virus (Finland, Sweden, Germany, Russia). Case fatality rate 1–15%. Acute kidney injury 1–8 weeks after exposure.

Transmission: aerosols from infected rodent urine/droppings/saliva. Person-to-person transmission documented only for Andes virus.

## Update cadence

Ingestion runs every 6 hours via GitHub Actions cron (workflow `.github/workflows/sync.yml`, schedule `5 */6 * * *`). Each run polls WHO RSS, CDC's hantavirus page, NewsAPI and GDELT 2.0 DOC API (multilingual) for `hantavirus OR puumala OR "andes virus" OR HFRS OR HPS` over the last 7 days; AI-normalises country / region / case counts via OpenRouter (meta-llama/llama-3.1-8b-instruct primary, meta-llama/llama-3.2-3b-instruct:free fallback); scrapes `og:image` per article via Workers HTMLRewriter; writes news + case rows to Cloudflare D1; busts public KV cache. Cases are only minted for URLs from authoritative-source domains (WHO/CDC/PAHO/ECDC/national MoH); news outlets re-reporting an outbreak add news rows, not case rows.