Farmland Soil, Water & Drought Report
Before buying, leasing or planting a US parcel, reads the USDA NRCS soil survey at a point (lat/lon or US address): map unit, prime farmland class, land capability class and subclass, drainage, hydric rating, flooding and ponding frequency, water table and bedrock depth, slope, pH, organic matter, available water capacity (percent-weighted across components) and building-site ratings with shrink-swell; adds depth to groundwater at the nearest recently measured USGS well and the US Drought Monitor status and four-week trend for the county. Rates the stated use (cropland, pasture, orchard, building_site; all four if omitted) by the most limiting factor, listing every factor with its value, threshold, source URL and fetch time. Pure code, no LLM; no soil survey coverage returns INSUFFICIENT_DATA, and failed layers are listed rather than guessed. Not checked: water rights, local extension reports, crop yields, contamination. Not a soil test or agronomic advice.
What you get
A land-screening or agtech agent gets a signed, source-cited soil and water screen with explicit thresholds for each factor instead of a model's recollection of what the soil there is like.
Call it
Send the JSON body below to https://agents.writerslogic.com/api/v1/farmland-soil. An unpaid request answers 402 with the price and how to pay; a request that fails with a 5xx status is not charged.
curl -i -X POST https://agents.writerslogic.com/api/v1/farmland-soil \
-H 'content-type: application/json' \
-d '{"lat":42.03,"lon":-93.62,"use":"cropland"}'
Input
| Field | Type | Required | Description |
|---|---|---|---|
lat | number; -90..90 | no | WGS84 latitude. Give lat with lon, or address. |
lon | number; -180..180 | no | WGS84 longitude. |
address | string; length 5..200 | no | US street address, geocoded by the US Census geocoder. |
use | string; one of "cropland", "pasture", "orchard", "building_site" | no | Intended use to rate. Omit to rate all four. |
Example request body
{
"lat": 42.03,
"lon": -93.62,
"use": "cropland"
}
Result
The response is { "data": ..., "_provenance": ... }. data carries these fields; _provenance is a signed W3C Verifiable Credential with a C2PA-style manifest, checked free at POST /api/v1/verify-provenance.
| Field | Type | Required | Description |
|---|---|---|---|
status | string; one of "OK", "PARTIAL", "INSUFFICIENT_DATA" | yes | PARTIAL: a layer failed and is listed in failed_layers. INSUFFICIENT_DATA: no soil survey coverage or no usable soil properties at the point. |
reason | one of | yes | |
location | object | yes | |
map_unit | one of | yes | |
components | array<object> | yes | Soil components of the map unit at the point, with NRCS representative values; depths in cm, available water in cm of water. |
composition_summary | one of | yes | |
groundwater | one of | yes | |
drought | one of | yes | |
suitability | array<object> | yes | |
layers | array<object> | yes | |
failed_layers | array<string> | yes | |
not_checked | array<string> | yes | |
limits | string | yes | |
as_of | string | yes | |
llm | string; one of "not_used" | yes | |
disclaimer | string | yes |
Pay and connect
Available through: x402 (USDC on Base), MCP, RapidAPI, Apify.
Machine-readable
- This agent as JSON (schemas, example, OpenAPI operation)
- Free signed sample response
- OpenAPI 3.1 · Catalog · Index of every agent