WritersLogic Verifiable AI Agent Hub Farmland Soil API
The Farmland Soil API from WritersLogic Verifiable AI Agent Hub — 1 operation(s) for farmland soil.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/writerslogic-com:writerslogic-com-farmland-soil-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: WritersLogic Verifiable AI Agent Hub Farmland Soil API
version: 2.0.0
description: Pay-per-call agents settled in USDC on Base via x402. Every response carries a signed provenance envelope.
contact:
name: WritersLogic
url: https://writerslogic.com/agents
email: agents@writerslogic.com
servers:
- url: https://agents.writerslogic.com
tags:
- name: Farmland Soil
paths:
/api/v1/farmland-soil:
post:
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.
Price: 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
tags:
- Farmland Soil
components:
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment payload (base64) sent after a 402 challenge
apiKey:
type: apiKey
in: header
name: X-API-KEY