Custom Connector
Disease.sh Connector
Global
The disease.sh Connector provides a RESTful interface for accessing near real-time and historical global health data related to infectious diseases. It aggregates data from Worldometers, Johns Hopkins University, and the CDC, offering statistics on COVID-19, vaccinations, and influenza at global, country, state, and city levels — ideal for public health dashboards, research analytics, educational tools, or outbreak monitoring.
Overview
Integration Overview
The disease.sh Connector offers the following integration points to retrieve health-related data:
- Get global COVID-19 stats. Retrieve worldwide aggregate statistics on COVID-19.
- Get country-level data. Retrieve detailed statistics per country.
- Get vaccine coverage. Retrieve global and regional vaccination data.
- Get historical data. Retrieve time-series data for cases, deaths, and recoveries.
- Get U.S. states/counties data. Retrieve localized U.S. COVID-19 statistics.
- Get influenza & ILI trends. Retrieve CDC-reported influenza and ILI trends.
Documentation
Detailed Integration Documentation
Get Global COVID-19 Stats
| Operation ID | getGlobalCovidStats |
|---|---|
| Endpoint | /v3/covid-19/all |
| Purpose | Retrieves overall global COVID-19 statistics. |
| Parameters | Required: None. Optional: None. |
| Output | JSON with total cases, deaths, recovered, and update time. |
| Workflow example | Fetch and display total global COVID-19 stats in a dashboard header. |
Get Country-Level Data
| Operation ID | getCountryCovidStats |
|---|---|
| Endpoint | /v3/covid-19/countries/{country} |
| Purpose | Provides current and total COVID-19 statistics by country. |
| Parameters | Required: country – country name or ISO code (e.g. US, FR, IN). Optional: None. |
| Output | JSON with cases, deaths, recovered, active cases, tests, and vaccinations. |
| Workflow example | Use to populate a world map or a sortable country-wise table. |
Get Vaccine Coverage
| Operation ID | getVaccineCoverage |
|---|---|
| Endpoint | /v3/covid-19/vaccine/coverage |
| Purpose | Shows vaccine doses administered globally or by region. |
| Parameters | Optional: lastdays – number of days for historical trend (e.g. 30). |
| Output | JSON data of vaccine doses administered. |
| Workflow example | Display a timeline chart of global vaccine rollout. |
Get Historical Data
| Operation ID | getHistoricalData |
|---|---|
| Endpoint | /v3/covid-19/historical/{country} |
| Purpose | Retrieves historical COVID-19 statistics for a country or worldwide. |
| Parameters | Required: country. Optional: lastdays – number of days (e.g. 30, all). |
| Output | JSON time series of cases, deaths, and recoveries. |
| Workflow example | Plot daily trends using a line or area chart. |
Get U.S. States and Counties Data
| Operation ID | getUSStateCountyData |
|---|---|
| Endpoints | /v3/covid-19/states (all states); /v3/covid-19/states/{state} (specific state); /v3/covid-19/jhucsse/counties/{county} (specific county). |
| Purpose | Provides fine-grained COVID-19 data across U.S. regions. |
| Parameters | Required: state (for the state endpoint), county (for the county endpoint). Optional: None. |
| Output | JSON with localized U.S. COVID-19 statistics. |
| Workflow example | Build dashboards showing stats by state or county. |
Get Influenza & ILI Trends (via CDC)
| Operation ID | getILITrends |
|---|---|
| Endpoint | /v3/covid-19/nyt/counties and related |
| Purpose | Provides data on flu outbreaks and influenza-like illness (where available). |
| Parameters | None. |
| Output | JSON with flu-related regional data. |
| Workflow example | Track seasonal flu outbreaks across U.S. counties. |
Example Workflow: Public Health Monitoring Dashboard
| Retrieve region data | Use getCountryCovidStats or getUSStateCountyData to display region filters. |
|---|---|
| Display stats | Use getGlobalCovidStats or getCountryCovidStats for global or local COVID-19 stats. |
| Show vaccination progress | Use getVaccineCoverage to build trend visuals. |
| Historical trends | Use getHistoricalData for time-series visualization. |
| Handle errors | Implement error catching for 4xx/5xx responses and a fallback log. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.