# Agweb — 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 real-time agricultural news, commodity futures prices for corn and soybeans, and local cash grain bids to stay informed on market trends and pricing. Search articles by category, view detailed market analysis, and get weekend market reports to make informed farming and trading decisions.

**Category:** Finance & Markets | **Website:** [agweb.com/](https://agweb.com/) | **Docs:** [parse.bot/marketplace/256cfa48-41ea-4652-9969-af0784fb774a/agweb-com-api](https://parse.bot/marketplace/256cfa48-41ea-4652-9969-af0784fb774a/agweb-com-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-agweb-com-api-256cfa48/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get article detail

Retrieve full content and metadata for a specific article given its URL. Returns the article body text, structured metadata (title, dates, author, description), and tags. Use article URLs obtained from news listing or search endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the AgWeb article (e.g. https://www.agweb.com/news/crops/soybeans/biggest-threat-soybeans-now-are-late-herbicide-passes). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get cash grain bids

Retrieve location-based cash grain bids for elevators near a specific ZIP code. Returns detailed bid data including commodity names with grain grades, delivery months, basis, cash prices, and elevator location information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US ZIP code, leading zeros preserved (e.g. 61821, 50309). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_cash_grain_bids \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```

### Get corn futures

Convenience endpoint that retrieves detailed futures contract data for Corn (ZC symbol). Equivalent to calling get_futures_data with symbol=ZC.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_corn_futures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get futures data

Retrieve detailed futures contract data for a specific commodity symbol from Barchart. Returns comprehensive price data, configuration, and contract details across multiple delivery months.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Commodity futures root symbol. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_futures_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get latest markets news

Retrieve the latest news from the Markets section of AgWeb. Returns market-related articles including analysis, USDA reports, and commodity news.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_latest_markets_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get latest news

Retrieve the latest general news articles from AgWeb across all categories. Returns article summaries with titles, URLs, publication dates, and authors. Equivalent to fetching the 'news' category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_latest_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market analysis

Retrieve expert market analysis articles from AgWeb's market-analysis section. Returns daily analyst commentary on grain, livestock, and commodity futures.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_market_analysis \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get markets overview

Retrieve a snapshot of major commodity market prices from Barchart. Returns market data with contract month, price, and change for major agricultural commodities.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_markets_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news by category

Retrieve news articles filtered by a specific agricultural category. Returns paginated article listings with titles, URLs, summaries, dates, and authors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | News category path. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_news_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get soybean futures

Convenience endpoint that retrieves detailed futures contract data for Soybeans (ZS symbol). Equivalent to calling get_futures_data with symbol=ZS.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_soybean_futures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get weekend market report

Retrieve the latest Weekend Market Report articles from AgWeb. Returns periodic market commentary covering grain, livestock, and commodity futures outlook.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/get_weekend_market_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search articles

Search AgWeb for articles using a keyword query. Returns matching articles with titles, URLs, and summaries. Summaries may be empty for some results. Results include both recent and archival matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase (e.g. corn, soybean prices, farm bill). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-agweb-com-api-256cfa48/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```