{"id":24543596,"url":"https://github.com/ropensci/rcites","last_synced_at":"2025-04-15T12:56:16.009Z","repository":{"id":102760105,"uuid":"113842199","full_name":"ropensci/rcites","owner":"ropensci","description":":package: R package to access the CITES Speciesplus database ","archived":false,"fork":false,"pushed_at":"2023-02-20T01:13:04.000Z","size":4978,"stargazers_count":14,"open_issues_count":1,"forks_count":6,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-02-07T07:41:34.158Z","etag":null,"topics":["api-client","cites","database","endangered-species","r","r-package","rstats","trade"],"latest_commit_sha":null,"homepage":"https://docs.ropensci.org/rcites","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/ropensci.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json"}},"created_at":"2017-12-11T09:59:27.000Z","updated_at":"2025-01-31T08:03:55.000Z","dependencies_parsed_at":"2023-07-20T07:15:29.723Z","dependency_job_id":null,"html_url":"https://github.com/ropensci/rcites","commit_stats":{"total_commits":448,"total_committers":13,"mean_commits":34.46153846153846,"dds":0.5870535714285714,"last_synced_commit":"a2db86b63f69a35a18cad4284ce6597e978c7618"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frcites","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frcites/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frcites/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Frcites/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci","download_url":"https://codeload.github.com/ropensci/rcites/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238845361,"owners_count":19540327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["api-client","cites","database","endangered-species","r","r-package","rstats","trade"],"created_at":"2025-01-22T20:14:17.674Z","updated_at":"2025-04-15T12:56:15.990Z","avatar_url":"https://github.com/ropensci.png","language":"R","funding_links":[],"categories":["Biosphere"],"sub_categories":["Terrestrial Wildlife"],"readme":"# rcites \u003cimg src=\"man/figures/rcites_logo.png\" width=\"130\" height=\"150\" align=\"right\"/\u003e\n\n[![R CMD Check](https://github.com/ropensci/rcites/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ropensci/rcites/actions/workflows/R-CMD-check.yaml)\n[![codecov](https://codecov.io/gh/ropensci/rcites/branch/master/graph/badge.svg)](https://app.codecov.io/gh/ropensci/rcites)\n[![status](https://tinyverse.netlify.com/badge/rcites)](https://CRAN.R-project.org/package=rcites)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n[![ROpenSci status](https://badges.ropensci.org/244_status.svg)](https://github.com/ropensci/software-review/issues/244)\n[![CRAN status](https://www.r-pkg.org/badges/version/rcites)](https://CRAN.R-project.org/package=rcites)\n[![CRAN downloads](https://cranlogs.r-pkg.org/badges/grand-total/rcites)](https://cran.r-project.org/package=rcites)\n[![Zenodo DOI](https://zenodo.org/badge/113842199.svg)](https://zenodo.org/badge/latestdoi/113842199)\n[![JOSS DOI](http://joss.theoj.org/papers/10.21105/joss.01091/status.svg)](https://doi.org/10.21105/joss.01091)\n\n\nAn R package to access information from the [Speciesplus](https://speciesplus.net/) database via the [Speciesplus/CITES Checklist API](https://api.speciesplus.net/documentation/v1.html). The package is available for download from [CRAN](https://cran.r-project.org/package=rcites) (stable version) and [Github](https://github.com/ropensci/rcites) (development version).\n\nPlease see the [release paper](https://doi.org/10.21105/joss.01091) for background information about the Convention on International Trade in Endangered Species of Wild Fauna and Flora ([CITES](https://cites.org/eng)), the Speciesplus database and basic information about the aim of the package.\n\n\n### Installation\n\nThe package can be installed from CRAN:\n\n```R\ninstall.packages(\"rcites\")\n```\n\nThe development version can be installed via the [`remotes`](https://CRAN.R-project.org/package=remotes) :package:\n\n```R\nremotes::install_github(\"ropensci/rcites\")\n```\n\n\n### Setup requirements and use\n\nTo set up a connection to the CITES Speciesplus database, a personal authentication token is required. Please see the vignette for details how to get a token and how to set the token for package use: [Get started with rcites](https://docs.ropensci.org/rcites/articles/a_get_started.html)\n\nAdditional information about specific use examples are provided for the\n[African bush elephant (*Loxodonta africana*)](https://docs.ropensci.org/rcites/articles/b_elephant.html).\nThe package usage for querying multiple species is described in another\nvignette entitled ['Bulk analysis with rcites'](https://docs.ropensci.org/rcites/articles/c_bulk_analysis.html).\n\n\n### Key features\n\nOnce the token is set, the package has five key features:\n\n- `spp_taxonconcept()`: [access the Speciesplus taxon concept](https://api.speciesplus.net/documentation/v1/taxon_concepts/index.html) and retrieve a taxon id\n- `spp_cites_legislation()`: [access CITES legislation data](https://api.speciesplus.net/documentation/v1/cites_legislation/index.html)\n- `spp_eu_legislation()`: [access EU legislation data](https://api.speciesplus.net/documentation/v1/eu_legislation/index.html)\n- `spp_distributions()`: [access a taxon distribution data](https://api.speciesplus.net/documentation/v1/distributions/index.html)\n- `spp_references()`: [access a listing reference data](https://api.speciesplus.net/documentation/v1/references/index.html)\n\n\n### Prefix information\n\nThe package functions have three different prefixes:\n\n- `set_` for `set_token()` to initially set the API token\n- `spp_` for the key features\n- `rcites_` for helper functions that are called within the key features\n\n\n### Citation information\n\nWhen citing, please refer to both the [package citation](https://docs.ropensci.org/rcites/authors.html) and the [release paper](https://doi.org/10.21105/joss.01091).\n\n\n## Contributors\n\n- [Main contributors](https://github.com/ropensci/rcites/graphs/contributors)\n\n- Reviewers of the package:\n  - [Noam Ross](https://github.com/noamross)\n  - [Margaret Siple](https://github.com/mcsiple)\n\n- Editor: [Scott Chamberlain](https://github.com/sckott)\n\n- Reporting issue(s):\n  - @FVFaleiro\n  - @eveskew\n  - @fleurhierink\n  - @wajra\n\n\n\n## Resources\n\nAnother package dealing with data from and about CITES, providing access to its\nwildlife trade database: [cites](https://github.com/ecohealthalliance/cites/)\n\nWhile creating this package, we greatly benefited from:\n\n1. [taxize](https://github.com/ropensci/taxize) that inspired the structuring of this repository/package;\n\n2. the `httr` vignette: [Managing secrets](https://CRAN.R-project.org/package=httr/vignettes/secrets.html), which is extremely helpful for packages dealing with API.\n\n\n\n## Code of Conduct\n\nPlease note that this project is released with a [Contributor Code of Conduct](https://docs.ropensci.org/rcites/CONDUCT.html).\nBy participating in this project you agree to abide by its terms.\n\nAlso, please read the Terms and Conditions of Use of Speciesplus Data:\nhttps://speciesplus.net/terms-of-use.\n\n\n[![ropensci_footer](https://ropensci.org/public_images/ropensci_footer.png)](https://ropensci.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Frcites","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Frcites","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Frcites/lists"}