rredlist is an R client for the IUCN Red List API
(https://api.iucnredlist.org). The IUCN Red List is the world’s
most comprehensive information source on the global extinction risk
status of animal, fungus, and plant species. This package provides
access via R to the various data contained within this database which
span range details, population size, habitat and ecology, use and/or
trade, threats, and conservation actions. The functions within the
package cover all endpoints of the IUCN Red List web API, which are
documented here.
CRAN
install.packages("rredlist")Development version
remotes::install_github("ropensci/rredlist")
# OR
install.packages("rredlist", repos = "https://ropensci.r-universe.dev/")Use of this package requires an IUCN API key which can be acquired at https://api.iucnredlist.org/users/sign_up. There is a helper function to help you get the key and store it properly:
rredlist::rl_use_iucn()Keep this key private. You can pass the key in to
each function via the key parameter, but it’s better to store the key
either as an environment variable (IUCN_REDLIST_KEY) or an
R option (iucn_redlist_key) - we recommend using the former
option. Note that there is not a default API key that is used as a
fallback, and the package will not function without providing/storing
your own API key.
library("rredlist")rl_species("Gorilla", "gorilla")$assessments
#> year_published latest possibly_extinct possibly_extinct_in_the_wild sis_taxon_id
#> 1 2016 FALSE FALSE FALSE 9404
#> 2 2018 TRUE FALSE FALSE 9404
#> 3 2016 FALSE FALSE FALSE 9404
#> 4 2008 FALSE FALSE FALSE 9404
#> 5 2007 FALSE FALSE FALSE 9404
#> 6 2000 FALSE FALSE FALSE 9404
#> 7 1996 FALSE FALSE FALSE 9404
#> 8 1994 FALSE FALSE FALSE 9404
#> 9 1990 FALSE FALSE FALSE 9404
...rl_actions()
#> $conservation_actions
#> en code
#> 1 Land/water protection 1
#> 2 Site/area protection 1_1
#> 3 Resource & habitat protection 1_2
#> 4 Land/water management 2
#> 5 Site/area management 2_1
#> 6 Invasive/problematic species control 2_2
#> 7 Habitat & natural process restoration 2_3
#> 8 Species management 3
...rl_actions("2_2", all = FALSE)$assessments
#> year_published latest possibly_extinct possibly_extinct_in_the_wild sis_taxon_id
#> 1 2019 TRUE FALSE FALSE 132523146
#> 2 2019 TRUE FALSE FALSE 10767
#> 3 2013 TRUE FALSE FALSE 1078
#> 4 2019 TRUE FALSE FALSE 132521900
#> 5 2020 FALSE FALSE FALSE 1086
#> 6 2019 TRUE FALSE FALSE 1117
#> 7 2019 FALSE FALSE FALSE 11797
#> 8 2021 TRUE FALSE FALSE 12124
#> 9 2025 TRUE FALSE FALSE 232775771
...
The rredlist logo showcases a silhouette of a Javan
rhinoceros (Rhinoceros sondaicus), one of the most
endangered mammal species on the planet. The species has suffered
extreme population decline due to habitat loss and poaching, with only
~75 individuals alive in the wild today, all in Ujung Kulon National
Park, a UNESCO World
Heritage Site in Java, Indonesia. Despite recent conservation
efforts, poaching
continues; further, the small population is extremely susceptible to
inbreeding, disease, and further habitat loss due to the rampant
spreading of local palm trees. You can read more about the Javan rhino
on the IUCN
Red List, World Wildlife
Fund, and International
Rhino Foundation.
This work, “rredlist logo”, is adapted from “Javan rhino silhouette” by Creazilla, used under CC BY 4.0. “rredlist logo” is licensed under CC BY 4.0 by William Gearty.
rredlist in R doing
citation(package = 'rredlist')
All contributions to this project are gratefully acknowledged using
the allcontributors
package following the allcontributors
specification. Contributions of any kind are welcome!
sckott |
willgearty |
maelle |
jeffreyhanson |
jeroen |
KevCaz |
