# Plantix — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Access a comprehensive agricultural database covering over 700 plant diseases and pests, with detailed symptoms, treatment options, and prevention methods. Browse cultivation guides for a wide range of crops, retrieve disease risk by growth stage, and explore expert agricultural blog posts — all through a single structured API.

**Category:** Other | **Website:** [plantix.net/](https://plantix.net/) | **Docs:** [parse.bot/marketplace/95cfbbff-521a-402b-9427-da96871a0282/plantix-net-api](https://parse.bot/marketplace/95cfbbff-521a-402b-9427-da96871a0282/plantix-net-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get blog article

Get the full content of a blog article by its slug. Returns the article title, full text content, and canonical URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The article slug (e.g. 'wheat-cultivation-tips'). Obtained from list_blog_articles results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/get-blog-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get crop detail

Get detailed cultivation and care information for a specific crop, including climate requirements, soil types, companion planting, crop rotation, and optimal NPK values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The crop slug in lowercase (e.g. 'tomato', 'wheat'). Obtained from list_crops results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/get-crop-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get crop probable diseases

Get probable diseases for a crop, organized by growth stage (e.g. Seedling, Vegetative, Flowering, Fruiting, Harvesting). Each disease entry includes ID, name, pathogen type, and scientific name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The crop slug in lowercase (e.g. 'tomato', 'wheat'). Obtained from list_crops results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/get-crop-probable-diseases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get plant disease detail

Get detailed information about a specific plant disease or pest, including symptoms, causes, treatment recommendations, and preventive measures. Requires both the numeric ID and slug, obtainable from list_plant_diseases results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The numeric ID of the disease (e.g. '600051'). Obtained from list_plant_diseases results. |
| `slug` | string | Yes | The URL slug of the disease (e.g. 'stink-bugs-on-maize-millet-and-sorghum'). Obtained from list_plant_diseases results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/get-plant-disease-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>","slug":"<string>"}'
```

### List blog articles

List blog articles from the Plantix blog. Supports pagination and keyword search filtering on article titles. Returns article title, slug, publication date, and excerpt.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter articles by title. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/list-blog-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### List crops

List all available crops in the library. Returns crop IDs, names, and slugs that can be used to filter diseases or fetch crop details.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/list-crops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List plant diseases

List all plant diseases and pests from the library. Supports filtering by keyword, crop, and pathogen type. Returns all matching diseases with basic metadata including name, scientific name, pathogen classification, and affected crops. Client-side filtering is applied after fetching the full library.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `crop` | string | No | Filter by crop ID in uppercase (e.g. TOMATO, WHEAT). Use list_crops to get available IDs. |
| `pathogen` | string | No | Filter by pathogen type. |
| `query` | string | No | Search keyword to filter disease names. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/plantix/list-plant-diseases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"crop":"<string>","pathogen":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.