# Agweb — 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 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.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.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.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.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.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.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.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.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.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.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.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.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.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>"}'
```