{"id":32204397,"url":"https://github.com/stangandaho/redlist","last_synced_at":"2026-02-24T04:03:34.561Z","repository":{"id":260710224,"uuid":"881833465","full_name":"stangandaho/redlist","owner":"stangandaho","description":"redlist R package provides interface to access data from the IUCN Red List, designed to support conservation efforts and biodiversity research by enabling users to programmatically access up-to-date Red List data.","archived":false,"fork":false,"pushed_at":"2025-11-25T17:28:23.000Z","size":6574,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-08T23:57:16.825Z","etag":null,"topics":["bioinformatics","conservation","ecology","iucn-red-list","iucn-red-list-in-r","redlist","redlist-r-package"],"latest_commit_sha":null,"homepage":"https://stangandaho.github.io/redlist/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stangandaho.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-01T10:37:15.000Z","updated_at":"2025-11-26T15:01:23.000Z","dependencies_parsed_at":"2025-07-23T20:23:59.387Z","dependency_job_id":"998ab2b9-8e65-46e1-bed2-16dce33d779d","html_url":"https://github.com/stangandaho/redlist","commit_stats":null,"previous_names":["stangandaho/redlist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stangandaho/redlist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stangandaho%2Fredlist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stangandaho%2Fredlist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stangandaho%2Fredlist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stangandaho%2Fredlist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stangandaho","download_url":"https://codeload.github.com/stangandaho/redlist/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stangandaho%2Fredlist/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29771052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:01:02.180Z","status":"ssl_error","status_checked_at":"2026-02-24T03:59:49.901Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioinformatics","conservation","ecology","iucn-red-list","iucn-red-list-in-r","redlist","redlist-r-package"],"created_at":"2025-10-22T04:54:47.174Z","updated_at":"2026-02-24T04:03:34.513Z","avatar_url":"https://github.com/stangandaho.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IUCN Red List R Package\n# \u003cimg src=\"man/figures/logo.png\" align=\"right\" height=\"100\" alt=\"redlist logo\"/\u003e\n\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/stangandaho/redlist/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/stangandaho/redlist/actions/workflows/R-CMD-check.yaml)\n[![CRAN status](https://www.r-pkg.org/badges/version/redlist)](https://CRAN.R-project.org/package=redlist)\n\u003c!-- badges: end --\u003e\n[![codecov](https://codecov.io/gh/stangandaho/redlist/graph/badge.svg?token=AS6SSJ8F1N)](https://app.codecov.io/gh/stangandaho/redlist)\n\n## About This Project\nStarted in September 2024, this project originated when [`rredlist`](https://github.com/ropensci/rredlist) \nwas still tied to the deprecated IUCN Red List V3 API. By January 2025, `rredlist` had transitioned to support \nthe V4 API, introducing substantial structural changes. I continued \ndeveloping my own approach, which led to [`redlist`](https://github.com/stangandaho/redlist) — a standalone client \ndesigned around consistent tibble outputs and streamlined workflows.  \n\nIn parallel, there is also the official IUCN-supported package \n[`iucnredlist`](https://iucn-uk.github.io/iucnredlist/), which provides direct access to the same V4 API. \nAlthough these packages all use API V4, they differ in design: `redlist` focuses on a fresh, independent approach \nwith uniform inputs and outputs for all endpoints, while `iucnredlist` represents the official reference implementation.  \nThese differences mean the packages are not in competition but are complementary, serving different user preferences.\n\n## Get started\n### 📦 Installation\n\n```r\n# Install from CRAN\ninstall.packages(\"redlist\")\n\n# Install from GitHub\nif (!requireNamespace(\"pak\", quietly = TRUE)) {\n  install.packages(\"pak\", dependencies = TRUE)\n}\npak::pkg_install(\"stangandaho/redlist\")\n\n# Load\nlibrary(redlist)\n```\n\n### 🔑 Set Your API Key\nIf you're using this package for the first time, you'll likely need an IUCN Red List API key.  \nYou can check whether it's set by running `rl_check_api()`.  \nIf this throws an error like '*! No Redlist API key found... *', you'll need to set \nan API key before using any of the package functions. Just follow these two simple steps:  \n1. Visit the official IUCN Red List API website [here](https://api.iucnredlist.org/users/edit). \nCreate an account if you don't already have one. Once logged in, you can request your API key.  \n2. Copy your API key and set it using the `rl_set_api()` function, like this `rl_set_api(\"2GoWiThmYrEDlitApiThatWorkS4me\")`.  \nYou can then run `rl_check_api()` again to confirm that your API key is set successfully.  \n\n\u003e *Please ensure that you have read and agreed to the [API key terms of use](https://www.iucnredlist.org/terms/terms-of-use) and have complied with them during your usage.*\n\n## Usage\n\nThe `redlist` package offers simple functions to retrieve and explore IUCN Red List data.\n\n```r\n# Retrieve Red List data for Benin (country code \"BJ\"), first page by default\nbenin_redlist \u003c- rl_countries(code = \"BJ\")  # Get first 100 records\nhead(benin_redlist)                         # Preview the data\n\n# Retrieve data from first 5 pages (up to 500 records)\nbenin_redlist_pages \u003c- rl_countries(code = \"BJ\", page = 1:5)\n\n# Retrieve data from first 5 pages, filtered by year published 2023\nbenin_redlist_2023 \u003c- rl_countries(code = \"BJ\", page = 1:5, year_published = 2023)\n\n# Retrieve all available data for Benin (no page limit)\nbenin_redlist_all \u003c- rl_countries(code = \"BJ\", page = NA)\n\n# Get detailed species info by passing a species sis_id (example: 137286)\nspecies_info \u003c- rl_sis(sis_id = 137286)\n\n# Get detailed assessment info by passing an assessment_id (example: 522738)\nassessment_info \u003c- rl_assessment_id(assessment_id = 522738)\n\n# Loop through multiple assessment_ids to collect detailed data for all species\nall_species_details \u003c- lapply(benin_redlist$assessments_assessment_id, function(id) {\n  rl_assessment_id(assessment_id = id)\n}) %\u003e% dplyr::bind_rows()\n```\n\n**For a full overview of all available functions, please visit the [redlist website](https://stangandaho.github.io/redlist/reference/index.html)**\n\n## Code of conduct\nPlease note that this project is based on the [Contributor Covenant v2.1](https://github.com/stangandaho/redlist/blob/main/CODE_OF_CONDUCT.md). \nBy participating in this project you agree to abide by its terms.\n\n## Getting help\nIf you encounter a clear bug, please file an [issue](https://github.com/stangandaho/redlist/issues) with a minimal reproducible \nexample. For questions and other discussion, please use [relevant section](https://github.com/stangandaho/redlist/discussions).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstangandaho%2Fredlist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstangandaho%2Fredlist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstangandaho%2Fredlist/lists"}