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.

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.

Note

Requires internet connection.

References

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

Examples

# Get data for Brazil
get_covid_stats_by_country_name("Brazil")

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

infectiousR documentation built on June 16, 2025, 5:09 p.m.