Public data on what's going around, for people, pets and farm animals. No accounts, no cookies. How it works

API v1

The forecast as JSON. Free, read-only, no key, no personal data.

Every number on the site comes from these endpoints: the level, the trend, the 4-week forecast with its intervals, how sure we are and which public sources it came from.

GET /api/v1/risk?region=US-TX&threat=flu

Items for one region. threat is optional. Region ids: WLD, ISO 3166 alpha-3 countries (USA), US states (US-TX), US counties by FIPS (US-48201).

200 OKapplication/json
{
  "region": "US-TX", "name": "Texas", "as_of": "2026-11-14",
  "items": [{
    "threat": "flu", "host": "human", "group": "people",
    "level": 3, "level_name": "High", "trend": "rising", "change_pct": 18,
    "nowcast": {"metric": "wastewater_level", "value": 5.9, "lo": 5.0, "hi": 6.8,
                "unit": "index", "period_end": "2026-11-14"},
    "forecast": [{"week": 1, "period_end": "2026-11-21", "value": 6.4,
                  "lo50": 5.9, "hi50": 6.9, "lo90": 5.2, "hi90": 7.8}, "..."],
    "p_event": null, "confidence": "high",
    "confidence_why": "Many sites report weekly across the state.",
    "sources": ["cdc_nwss", "cdc_nhsn"], "tag": "REAL",
    "basis": "state wastewater", "updated": "2026-11-19T12:00:00Z",
    "line": "Flu levels in wastewater across the state are high and rising.",
    "do": "Wash hands often, stay home when you feel unwell, and ask your doctor about vaccines."
  }],
  "sources": [{"name": "cdc_nwss", "licence": "US-PD", "attribution": "..."}]
}

GET /api/v1/region/US-48201

The region's name, level, parent, centre and population, plus its items and the nearby areas.

200 OK
{"region": {"id": "US-48201", "name": "Harris County", "level": "county",
            "parent": "US-TX", "lon": -95.39, "lat": 29.86, "pop": 4731145},
 "as_of": "2026-11-14", "items": ["..."], "nearby": [{"region": "US-48157", "...": "..."}]}

GET /api/v1/zip/77001

Resolves a 5-digit ZIP to its county and state, then returns both sets of items. The ZIP is used to pick the file and isn't stored. If you'd rather not send ZIPs at all, do what our site does: fetch /zips/770.json and look it up yourself.

200 OK
{"zip": "77001", "place": "Houston, TX",
 "county": {"region": "US-48201", "items": ["..."]},
 "state": {"region": "US-TX", "items": ["..."]}}

GET /api/v1/map/flu

Every region's weekly level and value for one threat: the observed weeks, then 4 forecast weeks with 90% ranges. forecast_from is the index of the first forecast week.

200 OK
{"threat": "flu", "host": "human", "metric": "wastewater_level",
 "weeks": ["2026-08-29", "...", "2026-12-12"], "forecast_from": 12,
 "regions": {"US-TX": {"level": [1, 1, 2, "..."], "value": [2.1, "..."],
                       "lo": [null, "...", 5.2], "hi": [null, "...", 7.8]}}}

GET /api/v1/threats
GET /api/v1/sources
GET /api/v1/health

What we track, every source with its licence and the credit line, and a status check (data date, whether the daily refresh layer is on).

/api/v1/health
{"ok": true, "as_of": "2026-11-14", "generated_at": "2026-11-19T12:00:00Z",
 "dev": false, "refresh_layer": true}

Credit the source

Each item lists its sources. /api/v1/sources gives each one's licence and the exact credit line. When you show the numbers, show the credit line. Most US sources are public domain; WHO FluNet is non-commercial only (CC BY-NC-SA 3.0 IGO), so leave it out of a paid product. Check commercial_ok.

Be gentle

No key and no sign-up. Responses are cached for 15 minutes and the data changes about once a day, so there's no need to poll faster. Keep it under about 60 requests a minute. For bulk use, read the static files under /data/ directly.

No personal data

GET only, open CORS, no cookies, no accounts. We don't log query strings beyond Cloudflare's standard request logs. Nothing in a response is about a person.

Errors are JSON: {"error": "bad region id"} with status 400, 404 when there's no file for that region, 405 for anything but GET. Tags: REAL published by the source, ESTIMATE worked out by us, SIMULATED made up. A latest_observed field appears when the daily refresh has a newer week than the last full forecast run.