Skip to contents

Get COVID-19 Statistics for a Specific Country

Source: R/get_covid_stats_by_country_name.R
get_covid_stats_by_country_name.Rd

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.

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.

Details

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

Note

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

References

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

Examples

if (FALSE) { # \dontrun{
# 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)
} # }