# Cornucopia — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_all_scorecards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_dairy_brand_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_dairy_scorecard_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_egg_scorecard_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_indie_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_news_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/get_research_documents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.beta.paywithlocus.com/api/wrapped/parse-cornucopia-org-api-bed94ea9/search_scorecard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","type":"<string>"}'
```