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

> Access organic food scorecards, brand ratings, research documents, and news from The Cornucopia Institute. Search and filter across dairy, egg, beef, poultry, and other organic product categories.

**Category:** Food & Dining | **Website:** [cornucopia.org/](https://cornucopia.org/) | **Docs:** [parse.bot/marketplace/bed94ea9-4967-4a1f-b4ef-6e6acb3dc882/cornucopia-org-api](https://parse.bot/marketplace/bed94ea9-4967-4a1f-b4ef-6e6acb3dc882/cornucopia-org-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/cornucopia/`
**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 all scorecards

Returns all available organic food scorecards published by The Cornucopia Institute. Each scorecard covers a product category (dairy, eggs, beef, poultry, plant-based beverages, cottage cheese, soy). The slug identifies the scorecard and can be used to construct URLs.

**Estimated cost:** Metered

_No parameters required._

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

### Get dairy brand detail

Retrieves detailed scoring rubric for a specific dairy brand identified by its slug. Returns the brand name, total score, and a rubric array where each entry contains criteria name, points awarded, and reviewer comments. Use slugs from get_dairy_scorecard_brands.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_slug` | string | Yes | Brand slug from the dairy scorecard listing (e.g. 'paradise-springs', 'working-cows-dairy') |

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

### Get dairy scorecard brands

Retrieves all brands from the Organic Dairy Scorecard. Each brand includes its name, star rating (1-5), products offered, numerical score, tier classification, and a slug for detail lookup. Brands are ordered by tier and score descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cornucopia/get-dairy-scorecard-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get egg scorecard brands

Retrieves all brands from the Organic Egg Scorecard. Each brand includes its name, star rating, numerical score, market area (US state abbreviation), tier classification, and a slug. Brands are ordered by tier and score descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cornucopia/get-egg-scorecard-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get indie brands

Retrieves all independent organic brands listed by The Cornucopia Institute. Each brand has a company name, product category, and optional logo URL. The list is alphabetically ordered.

**Estimated cost:** Metered

_No parameters required._

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

### Get news articles

Retrieves the latest news articles and newsletter archive entries from The Cornucopia Institute. Returns articles with title, URL, publication date (when available), and an excerpt of the content.

**Estimated cost:** Metered

_No parameters required._

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

### Get research documents

Retrieves research documents, reports, and buyer's guides published by The Cornucopia Institute. Each document includes a title, URL to the full document page, and a description summarizing its content.

**Estimated cost:** Metered

_No parameters required._

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

### Search scorecard

Searches for brands within a specific scorecard type by matching a keyword against brand names and products (case-insensitive substring match). Returns filtered results from the selected scorecard. Supports dairy, eggs, beef, and poultry scorecards.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against brand names and products (case-insensitive substring match) |
| `type` | string | No | Scorecard type to search within |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cornucopia/search-scorecard \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","type":"<string>"}'
```

## Next steps

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