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

> Track real-time produce commodity prices across 39 items in fruits, vegetables, melons, and more, with weekly updates and historical pricing data stretching back to 2005. Monitor price trends and build live price feeds to stay informed on market movements across the produce industry.

**Category:** Food & Dining | **Website:** [www.produceiq.com/index](https://www.produceiq.com/index) | **Docs:** [parse.bot/marketplace/c6f6b52f-0cd8-4a19-b5e7-2f487fe085fa/produceiq-com-api](https://parse.bot/marketplace/c6f6b52f-0cd8-4a19-b5e7-2f487fe085fa/produceiq-com-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-produceiq-com-api-c6f6b52f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_commodity_history

Get historical weekly price data for a specific commodity. Returns the commodity's current price, rate of change, and an array of weekly price records optionally filtered by year. Limit controls how many historical records are returned (most recent first). If the commodity name does not match any known commodity, returns a stale_input error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `commodity` | string | Yes | Commodity name to look up (case-insensitive partial match). Examples: 'avocados', 'strawberries', 'tomatoes', 'limes', 'potatoes'. |
| `limit` | integer | No | Maximum number of weekly price records to return. |
| `year` | string | No | Filter prices to a specific year (e.g. '2025', '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-produceiq-com-api-c6f6b52f/get_commodity_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commodity":"<string>","limit":"<integer>","year":"<string>"}'
```

### get_current_prices

Get the latest prices for all produce commodities. Returns current price per pound, weekly rate of change, and last update timestamp for each commodity. Optionally filter by category or commodity name (both case-insensitive partial match). Returns all 39 commodities when no filters applied.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter by category name (case-insensitive partial match). Accepts full category names or partial strings. |
| `commodity` | string | No | Filter by commodity name (case-insensitive partial match). Examples: 'avocados', 'strawberries', 'potatoes', 'limes'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-produceiq-com-api-c6f6b52f/get_current_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","commodity":"<string>"}'
```

### get_industry_index

Get the overall produce industry price index — a single weighted average price across all commodities, updated weekly. Returns weekly price records optionally filtered by year, plus the list of all available data years (2005 to present). Limit controls how many weekly records are returned (most recent first).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of weekly records to return. |
| `year` | string | No | Filter to a specific year (e.g. '2025', '2026'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-produceiq-com-api-c6f6b52f/get_industry_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","year":"<string>"}'
```