Farmland — USDA Land Values & Cash Rents for AI Agents

Average farmland values in dollars per acre by state, from the USDA NASS annual Land Values survey — each row is one state, year, and land category (farm_real_estate for the headline farm-real-estate value including buildings, cropland, or pasture) with its per-acre value (USD/acre). Use for what farmland is worth; use get_cash_rents instead for what it costs to rent, and list_coverage to confirm which states and years are stored before querying. Read-only lookup of stored survey data; no API key. The survey is annual and the stored copy refreshes once a year after the August NASS release — the latest stored year is 2026. `state` takes a two-letter code (case-insensitive) and `year` a single survey year; land values are state-level, so county fields are empty and a `county` filter normally matches nothing. Returns up to `limit` rows (default 1000), newest year first; a filter combination with no stored rows returns a no-data result rather than an empty list.

County cash rents in dollars per acre, from the USDA NASS annual Cash Rents survey — each row is one county (or an 'OTHER COUNTIES' aggregate) in one year and one practice category (irrigated_cropland, non_irrigated_cropland, or pasture), with the average rent in USD per acre. Use for what farmland rents for; use get_land_values instead for land values (what the land is worth), and list_coverage to check covered states, counties, and years. Read-only lookup of stored survey data; no API key. The survey is annual and the stored copy refreshes once a year after the August NASS release — the latest stored year is 2026. `state` takes a two-letter code (case-insensitive), `county` a county name exactly as stored (uppercase, e.g. 'HANCOCK'), and `year` a single survey year. Returns up to `limit` rows (default 1000), newest year first; a filter combination with no stored rows returns a no-data result rather than an empty list.

Lists what the Farmland API actually holds: row counts and the year range for each dataset (land values and cash rents), the total number of distinct states and counties covered, and the state codes present in each dataset. Use before get_land_values or get_cash_rents to confirm a state or year is covered — the stored data is currently a single survey year, 2026 — or to size a query. Read-only; no API key. This mirrors the REST /v1/status summary and adds the per-dataset state lists. It takes no parameters.

Takes no parameters.