{"id":26717299,"url":"https://github.com/sn4k3/speciesdatabaseapi","last_synced_at":"2026-05-04T02:36:02.544Z","repository":{"id":187558463,"uuid":"677186530","full_name":"sn4k3/SpeciesDatabaseApi","owner":"sn4k3","description":"Queries and fetch data from species, taxon and conservation database(s) to retrieve information using the provider API","archived":false,"fork":false,"pushed_at":"2023-08-20T03:18:44.000Z","size":430,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-31T04:52:48.861Z","etag":null,"topics":["api-rest","biota","conservation","database","iucn","marine","nature","regions","register","species","taxomony","taxomy","world","worms"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sn4k3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null},"funding":{"github":["sn4k3"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://paypal.me/SkillTournament"]}},"created_at":"2023-08-11T00:38:18.000Z","updated_at":"2023-08-11T18:54:02.000Z","dependencies_parsed_at":"2023-08-11T04:25:47.301Z","dependency_job_id":null,"html_url":"https://github.com/sn4k3/SpeciesDatabaseApi","commit_stats":{"total_commits":38,"total_committers":1,"mean_commits":38.0,"dds":0.0,"last_synced_commit":"8e682dfb3d600924234a84647fcd5032ed434a95"},"previous_names":["sn4k3/speciesdatabaseapi"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sn4k3%2FSpeciesDatabaseApi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sn4k3%2FSpeciesDatabaseApi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sn4k3%2FSpeciesDatabaseApi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sn4k3%2FSpeciesDatabaseApi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sn4k3","download_url":"https://codeload.github.com/sn4k3/SpeciesDatabaseApi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245877358,"owners_count":20687278,"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-rest","biota","conservation","database","iucn","marine","nature","regions","register","species","taxomony","taxomy","world","worms"],"created_at":"2025-03-27T15:52:10.263Z","updated_at":"2026-05-04T02:36:02.504Z","avatar_url":"https://github.com/sn4k3.png","language":"C#","funding_links":["https://github.com/sponsors/sn4k3","https://paypal.me/SkillTournament"],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/github/license/sn4k3/SpeciesDatabaseApi?style=for-the-badge)](https://github.com/sn4k3/SpeciesDatabaseApi/blob/master/LICENSE.txt)\n[![GitHub repo size](https://img.shields.io/github/repo-size/sn4k3/SpeciesDatabaseApi?style=for-the-badge)](#)\n[![Code size](https://img.shields.io/github/languages/code-size/sn4k3/SpeciesDatabaseApi?style=for-the-badge)](#)\n[![Nuget](https://img.shields.io/nuget/v/SpeciesDatabaseApi?style=for-the-badge)](https://www.nuget.org/packages/SpeciesDatabaseApi)\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/sn4k3?color=red\u0026style=for-the-badge)](https://github.com/sponsors/sn4k3)\n\u003c!--[![Downloads](https://img.shields.io/github/downloads/sn4k3/SpeciesDatabaseApi/total?style=for-the-badge)](https://github.com/sn4k3/SpeciesDatabaseApi/releases)!--\u003e\n\n\n\n# ![Icon](https://raw.githubusercontent.com/sn4k3/SpeciesDatabaseApi/master/images/icon-64.png) Species Database Api \n\nQueries and fetch data from species, taxon, regions and conservation database(s) to retrieve information using the provider API.\n\n## 🌐 Clients\n\n| Name / Provider                                                               | Class                                                                                                                                  | Terms of use                                                  |\n| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | \n| [Barcode of Life Data Sytem (BoldSystems)](https://www.boldsystems.org)       | [BoldSystemsClient](https://github.com/sn4k3/SpeciesDatabaseApi/blob/master/SpeciesDatabaseApi/BoldSystems/BoldSystemsClient.cs)       | [Terms of use](https://www.boldsystems.org/index.php/Resources/whatIsBOLD) |\n| [International Union for Conservation of Nature (IUCN)](https://www.iucn.org) | [IucnClient](https://github.com/sn4k3/SpeciesDatabaseApi/blob/master/SpeciesDatabaseApi/Iucn/IucnClient.cs)                            | [Terms of use](http://apiv3.iucnredlist.org/about) |\n| [Marine Regions](https://www.marineregions.org)                               | [MarineRegionsClient](https://github.com/sn4k3/SpeciesDatabaseApi/blob/master/SpeciesDatabaseApi/MarineRegions/MarineRegionsClient.cs) | [Terms of use](https://www.marineregions.org/disclaimer.php) |\n| [Species+/CITES](https://www.speciesplus.net)                                 | [SpeciesPlusClient](https://github.com/sn4k3/SpeciesDatabaseApi/blob/master/SpeciesDatabaseApi/SpeciesPlus/SpeciesPlusClient.cs)       | [Terms of use](https://www.speciesplus.net/terms-of-use) |\n| [World Register of Marine Species (WoRMS)](https://www.marinespecies.org)     | [WormsClient](https://github.com/sn4k3/SpeciesDatabaseApi/blob/master/SpeciesDatabaseApi/MarineSpecies/WormsClient.cs)                 | [Terms of use](https://www.marinespecies.org/about.php#terms) |\n\n## 🤝 Terms of use\n\nBefore the use of any provider you must accept and follow the terms of use of each used client. \nPlease refer to the \"terms of use\" from the above links.  \n\n## 🧬 Structure\n\n- Calls follow the async programming\n- Returned data have a class data model\n\n## Example (WoRMS)\n\n```C#\n  private static readonly WormsClient Client = new WormsClient();\n\n  private async void Main()\n  {\n     var result = await Client.GetAphiaRecordByAphiaId(105792);\n     Console.WriteLine(result);\n  }\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult:\u003c/summary\u003e\n\n```text\nAphiaId: 105792  \nUrl: https://marinespecies.org/aphia.php?p=taxdetails\u0026id=105792  \nScientificName: Carcharhinus leucas  \nAuthority: (Müller \u0026 Henle 1839)  \nTaxonRankId: 220  \nRank: Species  \nStatus: accepted  \nUnacceptReason:  \nValidAphiaID: 105792  \nValidName: Carcharhinus leucas  \nValidAuthority: (Müller \u0026 Henle 1839)  \nParentNameUsageId: 105719  \nKingdom: Animalia  \nPhylum: Chordata  \nClass: Elasmobranchii  \nOrder: Carcharhiniformes  \nFamily: Carcharhinidae  \nGenus: Carcharhinus  \nCitation: Froese R. and D. Pauly. Editors. (2023). FishBase. Carcharhinus leucas (Müller \u0026 Henle 1839). Accessed through: World Register of Marine Species at: https://marinespecies.org/aphia.php?p=taxdetails\u0026id=105792 on 2023-08-09  \nlsId: urn:lsid:marinespecies.org:taxname:105792  \nIsMarine: 1  \nIsBrackish: 1  \nIsFreshwater: 1  \nIsTerrestrial: 0  \nIsExtinct:  \nMatchType: Exact  \nModified: 15/01/2008 17:27:08  \n```\n\u003c/details\u003e\n\n\n## Example (IUCN)\n\n```C#\n  private static readonly IucnClient Client = new IucnClient(\"your-api-key\");\n\n  private async void Main()\n  {\n     var results = await Client.GetSpecieCommonNames(\"Carcharodon carcharias\");\n     foreach(var result in results)\n     {\n        Console.WriteLine(result);\n     }\n  }\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult:\u003c/summary\u003e\n\n```text\nTaxonName: White Shark, Primary: True, Language: eng\nTaxonName: Great White Shark, Primary: False, Language: eng\n```\n\u003c/details\u003e\n\n## 🗔 Command-line\n\nThe project **[SpeciesDatabaseCmd](https://github.com/sn4k3/SpeciesDatabaseApi/tree/master/SpeciesDatabaseCmd)** allow to call all the API using the command-line and also provide a sample on how to use the library.  \nRun the \"SpeciesDatabaseCmd.exe\" and follow the in-terminal instructions to call the commands.\n\n### Example: \n\n```bash\n# Usage:\n#   SpeciesDatabaseCmd [command] [options]\n# \n# Options:\n#   --version       Show version information\n#   -?, -h, --help  Show help and usage information\n# \n# Commands:\n#  BOLDSYSTEMS    Query - Barcode of Life Data Sytem (https://www.boldsystems.org)\n#  IUCN           Query - International Union for Conservation of Nature (http://www.iucnredlist.org)\n#  MARINEREGIONS  Query - Marine Regions (https://www.marineregions.org)\n#  SPECIES+       Query - Species+/CITES (https://www.speciesplus.net)\n#  WORMS          Query - World Register of Marine Species (https://www.marinespecies.org)\n\nSpeciesDatabaseCmd.exe IUCN SpecieCommonNames \"Carcharodon carcharias\"\n\n\u003e Name: Carcharodon carcharias\n\u003e Error:\n\u003e Message:\n\u003e IsSuccess: True\n\u003e Count: 2\n\u003e Results: 2\n\u003e ## Result[0]:\n\u003e TaxonName: White Shark\n\u003e Primary: True\n\u003e Language: eng\n\u003e ## Result[1]:\n\u003e TaxonName: Great White Shark\n\u003e Primary: False\n\u003e Language: eng\n```\n\n\n# 📦 Link package (Visual Studio)\n\n- Via \"Manage NuGet packages\"\n- Manually via terminal:\n```powershell\ndotnet add package SpeciesDatabaseApi\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsn4k3%2Fspeciesdatabaseapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsn4k3%2Fspeciesdatabaseapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsn4k3%2Fspeciesdatabaseapi/lists"}