{"id":"farmland-soil-report","title":"Farmland Soil, Water & Drought Report","description":"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.","roi":"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.","audience":"business","channels":["x402","mcp","rapidapi","apify"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/farmland-soil","path":"/api/v1/farmland-soil","contentType":"application/json"},"price":{"amount":"0.10","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"WGS84 latitude. Give lat with lon, or address."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"WGS84 longitude."},"address":{"type":"string","minLength":5,"maxLength":200,"description":"US street address, geocoded by the US Census geocoder."},"use":{"type":"string","enum":["cropland","pasture","orchard","building_site"],"description":"Intended use to rate. Omit to rate all four."}}},"resultSchema":{"type":"object","required":["status","reason","location","map_unit","components","composition_summary","groundwater","drought","suitability","layers","failed_layers","not_checked","limits","as_of","llm","disclaimer"],"properties":{"status":{"type":"string","enum":["OK","PARTIAL","INSUFFICIENT_DATA"],"description":"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":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"source":{"type":"string","enum":["input","census_geocoder"]},"matched_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"match_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"county":{"anyOf":[{"type":"object","properties":{"fips":{"type":"string"},"name":{"type":"string"},"state_fips":{"type":"string"}}},{"type":"null"}]}}},"map_unit":{"anyOf":[{"type":"object","properties":{"mukey":{"type":"string"},"name":{"type":"string"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"farmland_class":{"anyOf":[{"type":"string"},{"type":"null"}]},"acres":{"anyOf":[{"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"components":{"type":"array","description":"Soil components of the map unit at the point, with NRCS representative values; depths in cm, available water in cm of water.","items":{"type":"object"}},"composition_summary":{"anyOf":[{"type":"object","description":"Percent-weighted means and shares over components, each with coverage_pct (share of the map unit that had a value)."},{"type":"null"}]},"groundwater":{"anyOf":[{"type":"object","description":"Nearest USGS monitoring well with a static depth-to-water reading in the last three years (feet below land surface).","properties":{"well":{"anyOf":[{"type":"object"},{"type":"null"}]},"sites_considered":{"type":"integer"},"truncated":{"type":"boolean"},"source_url":{"type":"string"}}},{"type":"null"}]},"drought":{"anyOf":[{"type":"object","description":"US Drought Monitor county area percentages by category, status and four-week D1-or-worse trend."},{"type":"null"}]},"suitability":{"type":"array","items":{"type":"object","properties":{"use":{"type":"string","enum":["cropland","pasture","orchard","building_site"]},"rating":{"type":"string","enum":["well_suited","moderately_suited","poorly_suited","INSUFFICIENT_DATA"]},"rule":{"type":"string"},"limiting_factors":{"type":"array","items":{"type":"string"}},"unknown_factors":{"type":"array","items":{"type":"string"}},"factors":{"type":"array","items":{"type":"object","description":"id, label, value, unit, rating, threshold, coverage_pct, source_layers"}}}}},"layers":{"type":"array","items":{"type":"object","description":"Per fetch: layer, status, method, url, query, fetched_at, bytes, response_sha256, error"}},"failed_layers":{"type":"array","items":{"type":"string"}},"not_checked":{"type":"array","items":{"type":"string"}},"limits":{"type":"string"},"as_of":{"type":"string"},"llm":{"type":"string","enum":["not_used"]},"disclaimer":{"type":"string"}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","required":["status","reason","location","map_unit","components","composition_summary","groundwater","drought","suitability","layers","failed_layers","not_checked","limits","as_of","llm","disclaimer"],"properties":{"status":{"type":"string","enum":["OK","PARTIAL","INSUFFICIENT_DATA"],"description":"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":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"source":{"type":"string","enum":["input","census_geocoder"]},"matched_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"match_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"county":{"anyOf":[{"type":"object","properties":{"fips":{"type":"string"},"name":{"type":"string"},"state_fips":{"type":"string"}}},{"type":"null"}]}}},"map_unit":{"anyOf":[{"type":"object","properties":{"mukey":{"type":"string"},"name":{"type":"string"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"farmland_class":{"anyOf":[{"type":"string"},{"type":"null"}]},"acres":{"anyOf":[{"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"components":{"type":"array","description":"Soil components of the map unit at the point, with NRCS representative values; depths in cm, available water in cm of water.","items":{"type":"object"}},"composition_summary":{"anyOf":[{"type":"object","description":"Percent-weighted means and shares over components, each with coverage_pct (share of the map unit that had a value)."},{"type":"null"}]},"groundwater":{"anyOf":[{"type":"object","description":"Nearest USGS monitoring well with a static depth-to-water reading in the last three years (feet below land surface).","properties":{"well":{"anyOf":[{"type":"object"},{"type":"null"}]},"sites_considered":{"type":"integer"},"truncated":{"type":"boolean"},"source_url":{"type":"string"}}},{"type":"null"}]},"drought":{"anyOf":[{"type":"object","description":"US Drought Monitor county area percentages by category, status and four-week D1-or-worse trend."},{"type":"null"}]},"suitability":{"type":"array","items":{"type":"object","properties":{"use":{"type":"string","enum":["cropland","pasture","orchard","building_site"]},"rating":{"type":"string","enum":["well_suited","moderately_suited","poorly_suited","INSUFFICIENT_DATA"]},"rule":{"type":"string"},"limiting_factors":{"type":"array","items":{"type":"string"}},"unknown_factors":{"type":"array","items":{"type":"string"}},"factors":{"type":"array","items":{"type":"object","description":"id, label, value, unit, rating, threshold, coverage_pct, source_layers"}}}}},"layers":{"type":"array","items":{"type":"object","description":"Per fetch: layer, status, method, url, query, fetched_at, bytes, response_sha256, error"}},"failed_layers":{"type":"array","items":{"type":"string"}},"not_checked":{"type":"array","items":{"type":"string"}},"limits":{"type":"string"},"as_of":{"type":"string"},"llm":{"type":"string","enum":["not_used"]},"disclaimer":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"lat":42.03,"lon":-93.62,"use":"cropland"},"openapiOperation":{"operationId":"farmland_soil_report","summary":"Farmland Soil, Water & Drought Report","description":"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.\n\nPrice: 0.10 USDC on Base (x402).","x-x402-price-usdc":"0.10","x-x402-amount":"100000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/farmland-soil-report","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"WGS84 latitude. Give lat with lon, or address."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"WGS84 longitude."},"address":{"type":"string","minLength":5,"maxLength":200,"description":"US street address, geocoded by the US Census geocoder."},"use":{"type":"string","enum":["cropland","pasture","orchard","building_site"],"description":"Intended use to rate. Omit to rate all four."}}},"example":{"lat":42.03,"lon":-93.62,"use":"cropland"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["status","reason","location","map_unit","components","composition_summary","groundwater","drought","suitability","layers","failed_layers","not_checked","limits","as_of","llm","disclaimer"],"properties":{"status":{"type":"string","enum":["OK","PARTIAL","INSUFFICIENT_DATA"],"description":"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":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"source":{"type":"string","enum":["input","census_geocoder"]},"matched_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"match_count":{"anyOf":[{"type":"integer"},{"type":"null"}]},"county":{"anyOf":[{"type":"object","properties":{"fips":{"type":"string"},"name":{"type":"string"},"state_fips":{"type":"string"}}},{"type":"null"}]}}},"map_unit":{"anyOf":[{"type":"object","properties":{"mukey":{"type":"string"},"name":{"type":"string"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"farmland_class":{"anyOf":[{"type":"string"},{"type":"null"}]},"acres":{"anyOf":[{"type":"number"},{"type":"null"}]}}},{"type":"null"}]},"components":{"type":"array","description":"Soil components of the map unit at the point, with NRCS representative values; depths in cm, available water in cm of water.","items":{"type":"object"}},"composition_summary":{"anyOf":[{"type":"object","description":"Percent-weighted means and shares over components, each with coverage_pct (share of the map unit that had a value)."},{"type":"null"}]},"groundwater":{"anyOf":[{"type":"object","description":"Nearest USGS monitoring well with a static depth-to-water reading in the last three years (feet below land surface).","properties":{"well":{"anyOf":[{"type":"object"},{"type":"null"}]},"sites_considered":{"type":"integer"},"truncated":{"type":"boolean"},"source_url":{"type":"string"}}},{"type":"null"}]},"drought":{"anyOf":[{"type":"object","description":"US Drought Monitor county area percentages by category, status and four-week D1-or-worse trend."},{"type":"null"}]},"suitability":{"type":"array","items":{"type":"object","properties":{"use":{"type":"string","enum":["cropland","pasture","orchard","building_site"]},"rating":{"type":"string","enum":["well_suited","moderately_suited","poorly_suited","INSUFFICIENT_DATA"]},"rule":{"type":"string"},"limiting_factors":{"type":"array","items":{"type":"string"}},"unknown_factors":{"type":"array","items":{"type":"string"}},"factors":{"type":"array","items":{"type":"object","description":"id, label, value, unit, rating, threshold, coverage_pct, source_layers"}}}}},"layers":{"type":"array","items":{"type":"object","description":"Per fetch: layer, status, method, url, query, fetched_at, bytes, response_sha256, error"}},"failed_layers":{"type":"array","items":{"type":"string"}},"not_checked":{"type":"array","items":{"type":"string"}},"limits":{"type":"string"},"as_of":{"type":"string"},"llm":{"type":"string","enum":["not_used"]},"disclaimer":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/farmland-soil-report/","docsJson":"https://agents.writerslogic.com/docs/farmland-soil-report.json","sample":"https://agents.writerslogic.com/api/v1/samples/farmland-soil-report","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}