# Plantsforafuture — 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.

> Search for edible and medicinal plants to discover their culinary and health uses, cultivation tips, and physical characteristics. Browse the comprehensive plant database alphabetically or look up detailed information about specific plants' benefits and growing requirements.

**Category:** Other | **Website:** [plantsforafuture.org/](https://plantsforafuture.org/) | **Docs:** [parse.bot/marketplace/4e78b490-23c9-4f6e-9d81-211259d99548/plantsforafuture-org-api](https://parse.bot/marketplace/4e78b490-23c9-4f6e-9d81-211259d99548/plantsforafuture-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-plantsforafuture-org-api-4e78b490/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_plants_alphabetically

Browse the entire plant database alphabetically by the first letter of the Latin name. Returns all plants whose Latin name starts with the specified letter. Results are not paginated; the full set for that letter is returned. Useful for discovering plants when no specific search term is known.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to browse by |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-plantsforafuture-org-api-4e78b490/browse_plants_alphabetically \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_plant_details

Retrieve full details for a specific plant by its exact Latin name. Returns edibility and medicinal ratings, known hazards, habitat, geographic range, cultivation details, propagation methods, physical characteristics, and detailed use descriptions. The latin_name must match exactly as it appears in search results (case-sensitive, including subspecies if applicable).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latin_name` | string | Yes | The exact Latin name of the plant as it appears in search results (e.g. 'Rosa canina', 'Allium cepa') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-plantsforafuture-org-api-4e78b490/get_plant_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latin_name":"<string>"}'
```

### search_plants

Full-text search over the PFAF plant database by Latin name. Returns a list of matching plants with summary characteristics (habit, height, hardiness, soil/shade/moisture preferences, edible/medicinal/other ratings). Partial matches are supported — searching 'Rosa' returns all species in that genus. Results are not paginated; the full matching set is returned in one response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Latin name or partial Latin name to search for (e.g. 'Rosa', 'Allium') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-plantsforafuture-org-api-4e78b490/search_plants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```