get_covid_stats_by_country_name: Get COVID-19 Statistics for a Specific Country

In infectiousR: Access Infectious and Epidemiological Data via 'disease.sh API'

Get COVID-19 Statistics for a Specific Country

Description

Retrieves COVID-19 totals for a given country using the 'disease.sh' API.

Usage

get_covid_stats_by_country_name(
  country,
  yesterday = FALSE,
  twoDaysAgo = FALSE,
  strict = TRUE,
  allowNull = FALSE
)

Arguments

country	Character. A country name, ISO2, ISO3 code, or country ID.
yesterday	Logical. If TRUE, gets data reported from the previous day. Default is FALSE.
twoDaysAgo	Logical. If TRUE, gets data reported two days ago. Default is FALSE.
strict	Logical. If TRUE (default), disables fuzzy matching (e.g., avoids confusion between "Oman" and "Romania").
allowNull	Logical. If TRUE, allows null values (returned as NA). Default is FALSE.

Details

This function accesses COVID-19 data for a specific country based on its name or ISO code. Requires an active internet connection.

Value

A data frame with the following columns:

• country: Country name.

• updated: Timestamp of last update (POSIXct in UTC).

• cases: Total confirmed cases.

• todayCases: New confirmed cases today.

• deaths: Total deaths.

• recovered: Total recoveries.

• population: Estimated population.

Returns NULL if the API is unavailable, the country is not found, or an error occurs.

Note

Requires internet connection. Function fails gracefully if API is unavailable.

References

API Docs: https://disease.sh/docs/#/COVID-19

Examples

## Not run: 
# Get data for Brazil
brazil_data <- get_covid_stats_by_country_name("Brazil")
if (!is.null(brazil_data)) {
  print(brazil_data)
}

# Get data for the USA using ISO2 code
usa_data <- get_covid_stats_by_country_name("US", yesterday = TRUE)

## End(Not run)

infectiousR documentation built on Nov. 9, 2025, 5:07 p.m.