Vol. CXIV · No. 1Thursday, June 4, 2026

Documentation

How EbolaScan works

A complete reference for the platform — what we track, where every data point comes from, how we verify signals, and how you can build on top of it.

01 · What is EbolaScan?

EbolaScan is a real-time surveillance platform for Ebola virus disease (EVD). We aggregate verified outbreak signals from official health agencies, peer-reviewed reports, and live news, then plot them on an interactive global map.

The platform tracks confirmed and suspected cases, deaths, and active outbreaks across affected countries, with data sourced from WHO, CDC, Africa CDC, and national health ministries.

02 · Data sources

  • WHO Disease Outbreak News (DONs) — primary source for international notifications.
  • ProMED-mail — physician-reported outbreak signals, often days ahead of WHO.
  • Africa CDC — continent-wide Ebola surveillance and response coordination.
  • CDC (US) — Morbidity and Mortality Weekly Report and travel health notices.
  • National health ministries — DRC, Guinea, Uganda, Sierra Leone, etc.
  • Live news — Google News RSS, country-tagged and severity-classified.

03 · Methodology

Every case shown on the tracker meets at least one of these criteria:

  • PCR or serology-confirmed by an official lab (INRB, CDC, Pasteur, etc.)
  • Listed in a WHO DON or Africa CDC situation report
  • Reported in ≥2 independent ProMED posts or major news outlets

The map only shows signals from the last 14 days by default to reflect the active surveillance window. Severity is classified as critical / high / moderate / low based on case count, fatality rate, and geographic spread.

04 · The live tracker

The home page (/) is a full-screen Leaflet map with verified cases, exposure sites, ProMED signals, and live news mentions. Click any marker for case details, source links, and contact-tracing summaries. The live ticker streams the latest signals, and stat cards show 14-day totals, CFR, and contacts exposed.

05 · Country pages

Every affected country has a dedicated page at /country/[ISO] (e.g. /country/CD for DRC) with confirmed/suspected/death counts, source citations, contextual notes, and species breakdowns.

06 · Education & prevention

  • /how-it-spreads — transmission routes: bodily fluids, contaminated surfaces, unsafe burial, zoonotic spillover
  • /prevention — practical guide for healthcare workers, communities, and travellers
  • /history — timeline of major outbreaks since 1976
  • /faq — symptoms, incubation period, vaccines, treatment options

07 · Public API

All verified data is available via a free, CORS-enabled JSON API. See /api for the full reference. Endpoints:

  • GET /api/public/cases
  • GET /api/public/stats
  • GET /api/public/feed

An API key is required — pass it via the x-api-key header. Rate limit: 60 req/min per IP.

To request a key, DM @EbolaScan on X. Keys are free and usually issued within 24h.

Released under CC BY 4.0 — please attribute ebolascan.com.

08 · Telegram bot

@EbolaScan_bot opens the live tracker as a Telegram Mini App and accepts commands like /status and /cases for quick check-ins on the go.

09 · Contact & contributing

Found bad data, broken sources, or want to contribute a verified signal? Reach out on X (@EbolaScan) or via Telegram. Source citations are mandatory for any contribution.

— End of dispatch —