> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# USDA

> USDA National Agricultural Statistics Service API providing crop production, livestock inventories, commodity prices, and farm economics data.

USDA National Agricultural Statistics Service API providing crop production, livestock inventories, commodity prices, and farm economics data. Best for agricultural market analysis, commodity price tracking, or supply chain workflows that depend on crop yield forecasts. The authoritative source for U.S. agricultural data — no commercial alternative covers the breadth of NASS surveys.

1 example endpoint available through Lava's AI Gateway. See the [USDA API docs](https://quickstats.nass.usda.gov/api) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

<Info>This is a **catch-all provider** — any valid URL under `https://quickstats.nass.usda.gov/api` is supported. USDA NASS QuickStats API. Construct URL as [https://quickstats.nass.usda.gov/api/\&#123;endpoint\&#125](https://quickstats.nass.usda.gov/api/\&#123;endpoint\&#125);. Common endpoints: /api\_GET/?source\_desc=SURVEY\&commodity\_desc=CORN\&year=2024, /get\_param\_values/?param=commodity\_desc, /get\_counts/?commodity\_desc=CORN. Auth params (key, format) are added automatically. The endpoints below are curated examples.</Info>

## Endpoints

### Query agricultural statistics

**GET** `https://quickstats.nass.usda.gov/api/api_GET/?source_desc=SURVEY&commodity_desc=CORN&year=2024` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://quickstats.nass.usda.gov/api/api_GET/?source_desc=SURVEY&commodity_desc=CORN&year=2024', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fquickstats.nass.usda.gov%2Fapi%2Fapi_GET%2F%3Fsource_desc%3DSURVEY%26commodity_desc%3DCORN%26year%3D2024" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>
