# IUCN Integrations
Established in 1964, The International Union for Conservation of Nature’s Red List of Threatened Species has evolved to become the world’s most comprehensive information source on the global conservation status of animal, fungi and plant species.
The IUCN Red List is a critical indicator of the health of the world’s biodiversity. Far more than a list of species and their status, it is a powerful tool to inform and catalyze action for biodiversity conservation and policy change, critical to protecting the natural resources we need to survive. It provides information about range, population size, habitat and ecology, use and/or trade, threats, and conservation actions that will help inform necessary conservation decisions.
## Table of Contents
- [Introduction](#introduction)
- [Features](#features)
- [Getting Started](#getting-started)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## Introduction
The IUCN Red List is used by government agencies, wildlife departments, conservation-related non-governmental organisations (NGOs), natural resource planners, educational organisations, students, and the business community. The Red List process has become a massive enterprise involving the IUCN Global Species Program staff, partner organisations and experts in the IUCN Species Survival Commission and partner networks who compile the species information to make The IUCN Red List the indispensable product it is today.
## Features
This package gives you an up to date version of what currently exist on IUCN platform.
## Getting Started
Provide instructions on how to set up and run your project locally. Include prerequisites, installation steps, and any configuration needed.
### Basic information
The Red List API has been recently upgraded to offer more methods for querying the Red List data. Please make sure to use the correct methods for what you need.
The IUCN Red List version is 2022-2.
You will also need a token (https://apiv3.iucnredlist.org/api/v3/token) before being able to use the API.
## General information
The use of this API is strictly under the Terms of Use of the IUCN Red List of Threatened Species (http://www.iucnredlist.org/info/terms-of-use).
It is advisable wherever possible to use the taxon name (species name) to make your API calls, rather than using IDs. IDs are not immovable are expected to be used mainly by organisations that work closely with the IUCN Red List.
This API now supports querying regional assessments in addition to global assessments. This can achieved by appending a region_identifier parameter to the desired endpoint. Please see specific documentation for further details.
```bash
python requires=">=3.6"
```
## Installation
Use these command below to install the project:
```bash
pip install IUCN-API
```
## Usage
### Groups
```bash
from IUCN_API.modules.Groups import Groups
```
Group Methods you can access
```bash
group = Groups()
group.get_species_group_list()
group.get_species_by_group_name(group_name)
```
### Citations
```bash
from IUCN_API.modules.Citations import Citations
```
Citation Methods you can access
```bash
citation = Citations()
citation.get_species_citation_by_name(species_name="loxodonta africana")
citation.get_species_citation_region_by_name(region_identifier="europe", species_name="loxodonta africana")
citation.get_species_citation_by_id(species_id="299929")
citation.get_species_citation_region_by_id(region_identifier="europe", species_id="9929292")
```
### Conservation
```bash
from IUCN_API.modules.Conservation import Conservation
```
Conservation Methods you can access
```bash
conservation = Conservation()
conservation.get_species_conservation_measure_by_name(species_name)
conservation.get_species_conservation_measure_by_name_by_region(species_name, region_identifier)
conservation.get_species_conservation_measure_by_id(species_id)
conservation.get_species_conservation_measure_by_id_by_region(species_id, region_identifier)
```
### General
```bash
from IUCN_API.modules.General import General
```
General Methods you can access
```bash
general = General()
general.get_version()
general.get_countries()
general.get_regions()
general.get_species_by_country(country)
general.get_species(page=1, per_page=10)
general.get_species_region(region_identifier="europe", page=1, per_page=10)
general.get_species_count()
general.get_species_count_by_region(region_identifier="europe")
general.get_species_synonyms_by_name(species_name)
general.get_species_common_name_by_name(species_name)
general.get_species_by_category(category)
```
Growth Form
```bash
from IUCN_API.modules.GrowthForm import GrowthForm
```
GrowthForm Methods you can access
```bash
growth_form = GrowthForm()
growth_form.get_species_growth_forms_by_name(species_name)
growth_form.get_species_growth_forms_by_name_by_region(species_name, region_identifier)
growth_form.get_species_growth_forms_by_id(species_id)
growth_form.get_species_growth_forms_by_id_by_region(species_id, region_identifier)
```
### Habitats
```bash
from IUCN_API.modules.Habitats import Habitats
```
Habitats Methods you can access
```bash
habitats = Habitats()
habitats.get_species_habitat_by_name(species_name)
habitats.get_species_habitat_by_name_by_region(species_name, region_identifier)
habitats.get_species_habitat_by_id(species_id)
habitats.get_species_habitat_by_id_by_region(species_id, region_identifier)
```
### History
```bash
from IUCN_API.modules.History import History
```
History Methods you can access
```bash
history = History()
history.get_species_history_by_name(species_name)
history.get_species_history_by_name_by_region(species_name, region_identifier)
history.get_species_history_by_id(species_id)
history.get_species_history_by_id_by_region(species_id, region_identifier)
```
### Narratives
```bash
from IUCN_API.modules.Narratives import Narratives
```
Narratives Methods you can access
```bash
narratives = Narratives()
narratives.get_species_narrative_by_name(species_name)
narratives.get_species_narrative_by_name_by_region(species_name, region_identifier="europe")
narratives.get_species_narrative_by_id(species_id)
narratives.get_species_narrative_by_id_by_region(species_id, region_identifier="europe")
```
### Occurrence
```bash
from IUCN_API.modules.Occurrence import Occurrence
```
Occurrence Methods you can access
```bash
occurrence = Occurrence()
occurrence.get_species_country_occurence_by_name(species_name)
occurrence.get_species_country_occurence_by_name_by_region(species_name, region_identifier)
occurrence.get_species_country_occurence_by_id(species_id)
occurrence.get_species_country_occurence_by_id_by_region(species_id, region_identifier)
```
### Threats
```bash
from IUCN_API.modules.Threats import Threats
```
Threats Methods you can access
```bash
threats = Threats()
threats.get_species_threats_by_name(species_name)
threats.get_species_threats_by_name_by_region(species_name, region_identifier):
threats.get_species_threats_by_id(species_id)
threats.get_species_threats_by_id_by_region(species_id, region_identifier)
```
### View
```bash
from IUCN_API.modules.View import View
```
View Methods you can access
```bash
view = View()
view.get_species_single_by_name(species_name)
view.get_species_single_by_name_by_region(species_name, region_identifier="europe")
view.get_species_single_by_id(species_id)
view.get_species_single_by_id_by_region(species_id, region_identifier="europe")
```
### Weblinks
```bash
from IUCN_API.modules.Weblinks import Weblinks
```
Weblinks Methods you can access
```bash
weblinks = Weblinks()
weblinks.get_red_list_website_link_name(species_name:str="")
weblinks.get_red_list_website_redirect_name(species_name:str="")
weblinks.get_red_list_website_link_id(taxon_id:int="")
weblinks.get_red_list_website_redirect_id(taxon_id:int="", region_identifier:str="")
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ebenco94/IUCN_API",
"name": "IUCN-API",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "IUCN,Red list,Extinction,Animal,plant,IUCN API",
"author": "Awotoro Ebenezer",
"author_email": "ebenco94@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/15/02/8cc04ee4edc5322d3dd1ac0865033495fdc47a49432d8adff4becbeb7d70/IUCN_API-0.1.6.tar.gz",
"platform": null,
"description": "# IUCN Integrations\r\n\r\nEstablished in 1964, The International Union for Conservation of Nature\u00e2\u20ac\u2122s Red List of Threatened Species has evolved to become the world\u00e2\u20ac\u2122s most comprehensive information source on the global conservation status of animal, fungi and plant species.\r\n\r\nThe IUCN Red List is a critical indicator of the health of the world\u00e2\u20ac\u2122s biodiversity. Far more than a list of species and their status, it is a powerful tool to inform and catalyze action for biodiversity conservation and policy change, critical to protecting the natural resources we need to survive. It provides information about range, population size, habitat and ecology, use and/or trade, threats, and conservation actions that will help inform necessary conservation decisions.\r\n\r\n## Table of Contents\r\n\r\n- [Introduction](#introduction)\r\n- [Features](#features)\r\n- [Getting Started](#getting-started)\r\n- [Installation](#installation)\r\n- [Usage](#usage)\r\n- [Contributing](#contributing)\r\n- [License](#license)\r\n\r\n## Introduction\r\n\r\nThe IUCN Red List is used by government agencies, wildlife departments, conservation-related non-governmental organisations (NGOs), natural resource planners, educational organisations, students, and the business community. The Red List process has become a massive enterprise involving the IUCN Global Species Program staff, partner organisations and experts in the IUCN Species Survival Commission and partner networks who compile the species information to make The IUCN Red List the indispensable product it is today.\r\n\r\n## Features\r\n\r\nThis package gives you an up to date version of what currently exist on IUCN platform.\r\n\r\n## Getting Started\r\n\r\nProvide instructions on how to set up and run your project locally. Include prerequisites, installation steps, and any configuration needed.\r\n\r\n### Basic information\r\n\r\nThe Red List API has been recently upgraded to offer more methods for querying the Red List data. Please make sure to use the correct methods for what you need.\r\n\r\nThe IUCN Red List version is 2022-2.\r\n\r\nYou will also need a token (https://apiv3.iucnredlist.org/api/v3/token) before being able to use the API. \r\n\r\n\r\n## General information\r\n\r\nThe use of this API is strictly under the Terms of Use of the IUCN Red List of Threatened Species (http://www.iucnredlist.org/info/terms-of-use).\r\n\r\nIt is advisable wherever possible to use the taxon name (species name) to make your API calls, rather than using IDs. IDs are not immovable are expected to be used mainly by organisations that work closely with the IUCN Red List.\r\n\r\nThis API now supports querying regional assessments in addition to global assessments. This can achieved by appending a region_identifier parameter to the desired endpoint. Please see specific documentation for further details.\r\n\r\n```bash\r\npython requires=\">=3.6\"\r\n```\r\n\r\n## Installation\r\n\r\nUse these command below to install the project:\r\n\r\n```bash\r\npip install IUCN-API\r\n```\r\n\r\n\r\n## Usage\r\n\r\n### Groups\r\n\r\n\r\n```bash\r\nfrom IUCN_API.modules.Groups import Groups\r\n\r\n```\r\n\r\nGroup Methods you can access \r\n\r\n```bash\r\ngroup = Groups()\r\ngroup.get_species_group_list()\r\ngroup.get_species_by_group_name(group_name)\r\n\r\n```\r\n\r\n\r\n### Citations\r\n\r\n```bash\r\nfrom IUCN_API.modules.Citations import Citations\r\n\r\n```\r\n\r\nCitation Methods you can access \r\n\r\n```bash\r\ncitation = Citations()\r\ncitation.get_species_citation_by_name(species_name=\"loxodonta africana\")\r\ncitation.get_species_citation_region_by_name(region_identifier=\"europe\", species_name=\"loxodonta africana\")\r\ncitation.get_species_citation_by_id(species_id=\"299929\")\r\ncitation.get_species_citation_region_by_id(region_identifier=\"europe\", species_id=\"9929292\")\r\n\r\n```\r\n\r\n### Conservation\r\n\r\n```bash\r\nfrom IUCN_API.modules.Conservation import Conservation\r\n\r\n```\r\n\r\nConservation Methods you can access \r\n\r\n```bash\r\nconservation = Conservation()\r\nconservation.get_species_conservation_measure_by_name(species_name)\r\nconservation.get_species_conservation_measure_by_name_by_region(species_name, region_identifier)\r\nconservation.get_species_conservation_measure_by_id(species_id)\r\nconservation.get_species_conservation_measure_by_id_by_region(species_id, region_identifier)\r\n\r\n```\r\n\r\n\r\n### General\r\n\r\n```bash\r\nfrom IUCN_API.modules.General import General\r\n\r\n```\r\n\r\nGeneral Methods you can access \r\n\r\n```bash\r\ngeneral = General()\r\ngeneral.get_version()\r\ngeneral.get_countries()\r\ngeneral.get_regions()\r\ngeneral.get_species_by_country(country)\r\ngeneral.get_species(page=1, per_page=10)\r\ngeneral.get_species_region(region_identifier=\"europe\", page=1, per_page=10)\r\ngeneral.get_species_count()\r\ngeneral.get_species_count_by_region(region_identifier=\"europe\")\r\ngeneral.get_species_synonyms_by_name(species_name)\r\ngeneral.get_species_common_name_by_name(species_name)\r\ngeneral.get_species_by_category(category)\r\n\r\n```\r\n\r\n\r\nGrowth Form\r\n\r\n```bash\r\nfrom IUCN_API.modules.GrowthForm import GrowthForm\r\n\r\n```\r\n\r\nGrowthForm Methods you can access \r\n\r\n```bash\r\ngrowth_form = GrowthForm()\r\ngrowth_form.get_species_growth_forms_by_name(species_name)\r\ngrowth_form.get_species_growth_forms_by_name_by_region(species_name, region_identifier)\r\ngrowth_form.get_species_growth_forms_by_id(species_id)\r\ngrowth_form.get_species_growth_forms_by_id_by_region(species_id, region_identifier)\r\n\r\n```\r\n\r\n\r\n\r\n### Habitats\r\n\r\n```bash\r\nfrom IUCN_API.modules.Habitats import Habitats\r\n\r\n```\r\nHabitats Methods you can access \r\n\r\n```bash\r\nhabitats = Habitats()\r\nhabitats.get_species_habitat_by_name(species_name)\r\nhabitats.get_species_habitat_by_name_by_region(species_name, region_identifier)\r\nhabitats.get_species_habitat_by_id(species_id)\r\nhabitats.get_species_habitat_by_id_by_region(species_id, region_identifier)\r\n\r\n```\r\n\r\n\r\n### History\r\n\r\n```bash\r\nfrom IUCN_API.modules.History import History\r\n\r\n```\r\nHistory Methods you can access \r\n\r\n```bash\r\nhistory = History()\r\nhistory.get_species_history_by_name(species_name)\r\nhistory.get_species_history_by_name_by_region(species_name, region_identifier)\r\nhistory.get_species_history_by_id(species_id)\r\nhistory.get_species_history_by_id_by_region(species_id, region_identifier)\r\n\r\n```\r\n\r\n### Narratives\r\n\r\n```bash\r\nfrom IUCN_API.modules.Narratives import Narratives\r\n\r\n```\r\nNarratives Methods you can access \r\n\r\n```bash\r\nnarratives = Narratives()\r\nnarratives.get_species_narrative_by_name(species_name)\r\nnarratives.get_species_narrative_by_name_by_region(species_name, region_identifier=\"europe\")\r\nnarratives.get_species_narrative_by_id(species_id)\r\nnarratives.get_species_narrative_by_id_by_region(species_id, region_identifier=\"europe\")\r\n\r\n```\r\n\r\n\r\n### Occurrence\r\n\r\n```bash\r\nfrom IUCN_API.modules.Occurrence import Occurrence\r\n\r\n```\r\nOccurrence Methods you can access \r\n\r\n```bash\r\noccurrence = Occurrence()\r\noccurrence.get_species_country_occurence_by_name(species_name)\r\noccurrence.get_species_country_occurence_by_name_by_region(species_name, region_identifier)\r\noccurrence.get_species_country_occurence_by_id(species_id)\r\noccurrence.get_species_country_occurence_by_id_by_region(species_id, region_identifier)\r\n\r\n```\r\n\r\n\r\n### Threats\r\n\r\n```bash\r\nfrom IUCN_API.modules.Threats import Threats\r\n\r\n```\r\n\r\nThreats Methods you can access \r\n\r\n```bash\r\nthreats = Threats()\r\nthreats.get_species_threats_by_name(species_name)\r\nthreats.get_species_threats_by_name_by_region(species_name, region_identifier):\r\nthreats.get_species_threats_by_id(species_id)\r\nthreats.get_species_threats_by_id_by_region(species_id, region_identifier)\r\n\r\n```\r\n\r\n### View\r\n\r\n```bash\r\nfrom IUCN_API.modules.View import View\r\n\r\n```\r\nView Methods you can access \r\n\r\n```bash\r\nview = View()\r\nview.get_species_single_by_name(species_name)\r\nview.get_species_single_by_name_by_region(species_name, region_identifier=\"europe\")\r\nview.get_species_single_by_id(species_id)\r\nview.get_species_single_by_id_by_region(species_id, region_identifier=\"europe\")\r\n\r\n```\r\n\r\n\r\n### Weblinks\r\n\r\n```bash\r\nfrom IUCN_API.modules.Weblinks import Weblinks\r\n\r\n```\r\n\r\nWeblinks Methods you can access \r\n\r\n```bash\r\nweblinks = Weblinks()\r\nweblinks.get_red_list_website_link_name(species_name:str=\"\")\r\nweblinks.get_red_list_website_redirect_name(species_name:str=\"\")\r\nweblinks.get_red_list_website_link_id(taxon_id:int=\"\")\r\nweblinks.get_red_list_website_redirect_id(taxon_id:int=\"\", region_identifier:str=\"\")\r\n\r\n```\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A Python client for the IUCN Red List API",
"version": "0.1.6",
"project_urls": {
"Homepage": "https://github.com/ebenco94/IUCN_API"
},
"split_keywords": [
"iucn",
"red list",
"extinction",
"animal",
"plant",
"iucn api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8c3b0a9fb2a06e09bca6dbbd7a5bae8f95c7fe10599d7b8772be67fd29d8148b",
"md5": "ee1c64b9eb670b00e6122ddab3e763c3",
"sha256": "35a7f46a9041ea2da6d33795bd7918beb7416b53b3221385c8247b351b632581"
},
"downloads": -1,
"filename": "IUCN_API-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ee1c64b9eb670b00e6122ddab3e763c3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 12134,
"upload_time": "2023-08-22T16:10:05",
"upload_time_iso_8601": "2023-08-22T16:10:05.127452Z",
"url": "https://files.pythonhosted.org/packages/8c/3b/0a9fb2a06e09bca6dbbd7a5bae8f95c7fe10599d7b8772be67fd29d8148b/IUCN_API-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "15028cc04ee4edc5322d3dd1ac0865033495fdc47a49432d8adff4becbeb7d70",
"md5": "9debd5b48f8db4037b18a35a523b6703",
"sha256": "6a8bc81e1da481743f4674c828c57c7fc985d811d7a0e19f66efbb89cb99b7bd"
},
"downloads": -1,
"filename": "IUCN_API-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "9debd5b48f8db4037b18a35a523b6703",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 7391,
"upload_time": "2023-08-22T16:10:07",
"upload_time_iso_8601": "2023-08-22T16:10:07.066052Z",
"url": "https://files.pythonhosted.org/packages/15/02/8cc04ee4edc5322d3dd1ac0865033495fdc47a49432d8adff4becbeb7d70/IUCN_API-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-22 16:10:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ebenco94",
"github_project": "IUCN_API",
"github_not_found": true,
"lcname": "iucn-api"
}
JSON
