# Identify Plantnet — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Identify and explore plant species by searching through Pl@ntNet's comprehensive botanical database to access detailed information like taxonomic families, genera, species descriptions, photos, and community observations. Track plant distributions, view contribution trends, and discover expert contributors within the platform's collaborative plant identification community.

**Category:** Other | **Website:** [identify.plantnet.org/](https://identify.plantnet.org/) | **Docs:** [parse.bot/marketplace/4bd76ad0-2fb9-406e-ac0f-ef76e0da001b/identify-plantnet-org-api](https://parse.bot/marketplace/4bd76ad0-2fb9-406e-ac0f-ef76e0da001b/identify-plantnet-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_family

Get detailed information for a specific plant family including images organized by organ type, species count, genera count, common names, and GBIF identifier.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `family_name` | string | Yes | Scientific family name (e.g. 'Rosaceae') |
| `project_id` | string | Yes | Flora/project identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_family \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"family_name":"<string>","project_id":"<string>"}'
```

### get_family_genera

Get all genera belonging to a specific plant family, sorted by observation count descending. Returns paginated genera with species counts and common names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `family_name` | string | Yes | Scientific family name (e.g. 'Rosaceae') |
| `page` | integer | No | Page number (0-based) |
| `page_size` | integer | No | Number of results per page |
| `project_id` | string | Yes | Flora/project identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_family_genera \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"family_name":"<string>","page":"<integer>","page_size":"<integer>","project_id":"<string>"}'
```

### get_group

Get detailed information about a specific community group including owner, members count, observation count, species count, area, and recent observations from the group.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `group_id` | string | Yes | Group ID from list_groups results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_group \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group_id":"<string>"}'
```

### get_observation

Get full details of a specific observation by ID, including species determination votes, images with organ tags, geolocation (when public), and contributor information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `observation_id` | string | Yes | Observation ID from list_observations results |
| `project_id` | string | No | Flora/project identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_observation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"observation_id":"<string>","project_id":"<string>"}'
```

### get_species

Get detailed information for a specific species by its scientific name and flora key. Returns taxonomy, common names, synonyms, images organized by organ type (flower, leaf, fruit, bark, habit, other), GBIF/POWO links, uses, and statistics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `project_id` | string | Yes | Flora/project identifier (e.g. 'k-world-flora') |
| `scientific_name` | string | Yes | Scientific name of the species including author (e.g. 'Rosa canina L.') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_species \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"<string>","scientific_name":"<string>"}'
```

### get_species_galleries

Get image galleries for a specific species. When organ is specified, returns paginated images for that organ type. When organ is omitted, returns images grouped by all organ types (flower, leaf, fruit, bark, habit, other). Each image includes author, license, date, and observation reference.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `organ` | string | No | Filter by organ type: flower, leaf, fruit, bark, habit, other |
| `page` | integer | No | Page number (0-based), used when organ is specified |
| `page_size` | integer | No | Number of images per page, used when organ is specified |
| `project_id` | string | Yes | Flora/project identifier |
| `scientific_name` | string | Yes | Scientific name of the species including author |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_species_galleries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"organ":"<string>","page":"<integer>","page_size":"<integer>","project_id":"<string>","scientific_name":"<string>"}'
```

### get_species_map

Get geographic distribution map data for a specific species. Returns the GBIF species identifier and a URL to the distribution map PNG image hosted on the Pl@ntNet API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `project_id` | string | Yes | Flora/project identifier |
| `scientific_name` | string | Yes | Scientific name of the species including author (e.g. 'Rosa canina L.') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_species_map \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"<string>","scientific_name":"<string>"}'
```

### get_species_top_contributors

Get top contributors and identifiers for a specific species, ranked by number of contributions. Returns users who have contributed the most observations or identifications for the species.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `project_id` | string | Yes | Flora/project identifier |
| `scientific_name` | string | Yes | Scientific name of the species including author (e.g. 'Rosa canina L.') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_species_top_contributors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"<string>","scientific_name":"<string>"}'
```

### get_species_trends

Get temporal trend data (phenology / observations over time by month) for a specific species, broken down by plant organ. Shows monthly observation distribution for each organ type, useful for understanding flowering and fruiting seasons.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `project_id` | string | Yes | Flora/project identifier |
| `scientific_name` | string | Yes | Scientific name of the species including author (e.g. 'Rosa canina L.') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/get_species_trends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"<string>","scientific_name":"<string>"}'
```

### list_families

List all plant families for a given flora, paginated and sorted alphabetically. Returns families with species and genera counts, common names, and representative images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based) |
| `page_size` | integer | No | Number of results per page |
| `project_id` | string | No | Flora/project identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/list_families \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","project_id":"<string>"}'
```

### list_floras

List all available regional and thematic floras (projects) on Pl@ntNet. Returns groups of projects organized by region or theme. Use project IDs from this endpoint as the project_id parameter in other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/list_floras \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_genera

List all plant genera for a given flora, paginated and sorted alphabetically. Returns genera with family, species counts, and observation counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based) |
| `page_size` | integer | No | Number of results per page |
| `project_id` | string | No | Flora/project identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/list_genera \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","project_id":"<string>"}'
```

### list_groups

List all community groups on Pl@ntNet, sorted by most recently active. Returns paginated groups with member counts and descriptions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based) |
| `page_size` | integer | No | Number of results per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/list_groups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>"}'
```

### list_observations

List recent plant observations (contributions) for a given flora. Returns a paginated list sorted by most recent first. Each observation includes the identified species, contributor, images, geolocation (when public), and community votes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based) |
| `project_id` | string | No | Flora/project identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/list_observations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","project_id":"<string>"}'
```

### list_species

List all plant species for a given flora, paginated and sorted alphabetically. Returns species with scientific name, author, genus, family, common names, representative images, and observation counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based) |
| `page_size` | integer | No | Number of results per page |
| `project_id` | string | No | Flora/project identifier from list_floras (e.g. 'k-world-flora', 'useful', 'weeds', 'k-northern-europe') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/list_species \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","project_id":"<string>"}'
```

### search_families

Search plant families by scientific family name within a flora. Only scientific family names (e.g. 'Rosaceae', 'Asteraceae') are supported as search terms. Partial prefix matching is supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `project_id` | string | No | Flora/project identifier |
| `query` | string | Yes | Scientific family name or partial prefix (e.g. 'Rosa' matches 'Rosaceae') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/search_families \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"<string>","query":"<string>"}'
```

### search_species

Search species by scientific name, common name, genus, or family within a flora. Returns paginated matching results sorted by relevance. Partial matches are supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based) |
| `page_size` | integer | No | Number of results per page |
| `project_id` | string | No | Flora/project identifier |
| `query` | string | Yes | Search keyword (scientific name, common name, genus, or family) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-identify-plantnet-org-api-4bd76ad0/search_species \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","project_id":"<string>","query":"<string>"}'
```