# RHS Plants — 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 and browse the RHS Plants catalogue to discover thousands of plants and gardening products. Retrieve detailed specifications, growing conditions, images, and purchasing options for any plant, and filter or sort results by category or keyword.

**Category:** E-commerce | **Website:** [rhsplants.co.uk/](https://rhsplants.co.uk/) | **Docs:** [parse.bot/marketplace/87ad9fdb-3933-4555-a149-7ce29d086ae9/rhsplants-co-uk-api](https://parse.bot/marketplace/87ad9fdb-3933-4555-a149-7ce29d086ae9/rhsplants-co-uk-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-rhsplants-co-uk-api-87ad9fdb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_plant_detail

Get detailed information for a single plant by its full URL. Returns title, description, images, growing attributes (position, hardiness, flowering period, eventual height/spread, soil requirements), purchasing options with pricing, and companion plants. The URL must be a valid plant detail page URL from this site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the plant detail page (e.g. 'https://www.rhsplants.co.uk/plants/_/lavandula-angustifolia-hidcote/classid.4047/'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rhsplants-co-uk-api-87ad9fdb/get_plant_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### list_plants

List plants from the main catalogue with pagination and optional filtering/sorting. Returns paginated plant items with name, URL, image, and price. Supports sorting by popularity or price, and filtering to only orderable items. Each page returns up to `limit` items; iterate pages to walk the full catalogue.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `can_order` | boolean | No | Filter to only show orderable items. |
| `category_id` | string | No | Category ID to filter by. '29' returns all plants. |
| `limit` | integer | No | Items per page (max 100). |
| `page` | integer | No | Page number (1-indexed). |
| `sort` | string | No | Sort order. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rhsplants-co-uk-api-87ad9fdb/list_plants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"can_order":"<boolean>","category_id":"<string>","limit":"<integer>","page":"<integer>","sort":"<string>"}'
```

### list_plants_by_category

List plants for a specific category using its URL slug. Returns paginated plant items for the given category. Category slugs correspond to URL path segments on the site (e.g. 'perennials', 'shrubs', 'seeds', 'alpines-rockeries').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug from the site URL path (e.g. 'perennials', 'shrubs', 'seeds'). |
| `limit` | integer | No | Items per page. |
| `page` | integer | No | Page number (1-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rhsplants-co-uk-api-87ad9fdb/list_plants_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","limit":"<integer>","page":"<integer>"}'
```

### search_plants

Search for plants by keyword using the suggestion API. Returns matching plant results along with related categories. Limited to suggestion-style results (typically up to 10 items); for full catalogue browsing use list_plants or list_plants_by_category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'lavender', 'rose'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rhsplants-co-uk-api-87ad9fdb/search_plants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```