API Documentation

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "disease": "Ebola virus disease",
      "country": "DR Congo",
      "region": "africa",
      "lat": -4.0,
      "lng": 21.8,
      "risk_level": "high",
      "cases": 381,
      "deaths": 64,
      "date": "2026-06-03",
      "source": "https://www.who.int/emergencies/disease-outbreak-news/item/2026-DON603",
      "description": "As of 3 June 2026, the Ministry of Health DRC...",
      "is_pheic": false,
      "active": true
    }
  ],
  "total": 39,
  "limit": 50,
  "offset": 0
}

# All active outbreaks
curl "https://healthwatch-global.com/api/v1/outbreaks" \
  -H "X-API-Key: hwg_your_key_here"

# High-risk outbreaks in Africa, first 10
curl "https://healthwatch-global.com/api/v1/outbreaks?region=africa&risk=high&limit=10" \
  -H "X-API-Key: hwg_your_key_here"

# Paginate: skip first 50, get next 50
curl "https://healthwatch-global.com/api/v1/outbreaks?limit=50&offset=50" \
  -H "X-API-Key: hwg_your_key_here"

import requests

API_KEY = "hwg_your_key_here"
BASE    = "https://healthwatch-global.com/api/v1"

def get_outbreaks(region=None, risk=None, limit=50, offset=0):
    params = {"limit": limit, "offset": offset}
    if region: params["region"] = region
    if risk:   params["risk"]   = risk

    resp = requests.get(
        f"{BASE}/outbreaks",
        headers={"X-API-Key": API_KEY},
        params=params,
        timeout=10,
    )
    resp.raise_for_status()
    return resp.json()

# Example: all high-risk outbreaks
result = get_outbreaks(risk="high")
for outbreak in result["data"]:
    print(f"{outbreak['disease']} — {outbreak['country']} ({outbreak['risk_level']})")

const API_KEY = process.env.HEALTHWATCH_API_KEY; // never expose client-side
const BASE    = "https://healthwatch-global.com/api/v1";

interface Outbreak {
  id: string;
  disease: string;
  country: string;
  region: string;
  lat: number;
  lng: number;
  risk_level: "high" | "medium" | "low";
  cases: number;
  deaths: number;
  date: string;
  source: string; // WHO DON, ECDC, PAHO, or Africa CDC URL
  description: string;
  is_pheic: boolean;
  active: boolean;
}

interface OutbreakResponse {
  data: Outbreak[];
  total: number;
  limit: number;
  offset: number;
}

async function getOutbreaks(params?: {
  region?: "africa" | "asia" | "americas" | "europe" | "oceania";
  risk?: "high" | "medium" | "low";
  limit?: number;
  offset?: number;
}): Promise<OutbreakResponse> {
  const url = new URL(`${BASE}/outbreaks`);
  if (params?.region) url.searchParams.set("region", params.region);
  if (params?.risk)   url.searchParams.set("risk",   params.risk);
  if (params?.limit)  url.searchParams.set("limit",  String(params.limit));
  if (params?.offset) url.searchParams.set("offset", String(params.offset));

  const res = await fetch(url.toString(), {
    headers: { "X-API-Key": API_KEY! },
    next: { revalidate: 3600 }, // cache 1h in Next.js
  });

  if (!res.ok) throw new Error(`API error: ${res.status}`);
  return res.json();
}

// Example
const { data } = await getOutbreaks({ region: "africa", risk: "high" });
console.log(data);

<iframe
  src="https://healthwatch-global.com/widget?locale=en"
  width="400"
  height="320"
  frameborder="0"
  style="border-radius:12px;overflow:hidden;"
  title="HealthWatch Global — Live outbreak feed"
></iframe>

<iframe
  src="https://healthwatch-global.com/widget?locale=fr&region=africa&theme=light&limit=7"
  width="380"
  height="400"
  frameborder="0"
  style="border-radius:12px;"
  title="Foyers épidémiques en Afrique — HealthWatch Global"
></iframe>