# Nass — 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 comprehensive agricultural statistics from the USDA, including crop production data, livestock numbers, and farm economics through the QuickStats database, while also discovering available parameters and viewing the publications calendar. Search, filter, and retrieve detailed agricultural data by region, commodity, and time period to support farming decisions and agricultural analysis.

**Category:** Government & Public Data | **Website:** [nass.usda.gov/](https://nass.usda.gov/) | **Docs:** [parse.bot/marketplace/b56facbd-170e-47ed-a0b1-90fd87225c1b/nass-usda-gov-api](https://parse.bot/marketplace/b56facbd-170e-47ed-a0b1-90fd87225c1b/nass-usda-gov-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-nass-usda-gov-api-b56facbd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cropland_data_layer_links

Retrieve download links for the Cropland Data Layer (CDL) national and state-level datasets. Returns URLs for GeoTIFF/ZIP files including national CDLs (10m and 30m), cultivated layers, frequency layers, and confidence layers from 2008 to present. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nass-usda-gov-api-b56facbd/get_cropland_data_layer_links \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_publications_calendar

Retrieve scheduled reports from the NASS publications calendar for a specific month and year. Returns report titles with links to the calendar landing pages. Each report includes parsed URL parameters such as report_id, source, day, month, and year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | No | Month in zero-padded MM format (01-12). |
| `year` | string | No | Year in YYYY format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nass-usda-gov-api-b56facbd/get_publications_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","year":"<string>"}'
```

### quickstats_discover_params

Discover valid parameter values for building QuickStats queries using the keyless internal web API. Returns all accepted values for a target parameter, optionally filtered by sector. Use to enumerate sectors, commodity groups, commodities, states, statistical categories, and aggregation levels available in the QuickStats database.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sector_desc` | string | No | Filter values by sector. |
| `target_param` | string | No | The parameter to discover values for (e.g., sector_desc, group_desc, commodity_desc, state_alpha, statisticcat_desc, agg_level_desc). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nass-usda-gov-api-b56facbd/quickstats_discover_params \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sector_desc":"<string>","target_param":"<string>"}'
```