{"contractVersion":"parcelops.connector.v1","name":"usda-nass","displayName":"USDA Agricultural Land Values","description":"Official NASS Quick Stats agricultural land asset values at bounded state or county scope.","tags":["usda","nass","agricultural-land","rural-land","land-value","united-states","bring-your-own-key"],"authentication":{"type":"api_key","required":true},"provenance":{"sourceName":"USDA National Agricultural Statistics Service Quick Stats","sourceUrl":"https://quickstats.nass.usda.gov/api/api_GET/","apiBaseUrl":"https://quickstats.nass.usda.gov/api","documentationUrl":"https://quickstats.nass.usda.gov/api/"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"loadedAt","notes":"Follows NASS survey publication and Quick Stats load times."}},"coverage":{"geographic":{"status":"declared","value":["United States","NASS-published state and county agricultural statistics"]},"temporal":{"status":"not_declared"}},"methods":{"total":2,"items":[{"name":"getAgriculturalLandValues","description":"Get official agricultural land asset-value rows for one state/year or one county/year.","requiredParams":["stateAlpha","year"],"inputSchema":{"type":"object","properties":{"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$"},"countyCode":{"type":"string","pattern":"^\\d{3}$"},"year":{"type":"integer","minimum":1900,"maximum":2100}},"required":["stateAlpha","year"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"loadedAt","notes":"Follows NASS survey publication and Quick Stats load times."},"scope":"connector"},"entities":{"status":"declared","value":["agricultural-land-value-statistic"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Agricultural statistics are not parcel appraisals, comparable sales, rents, or soil-productivity measures.","Current exact cash-rent dimensions were not verified and are intentionally excluded.","Published disclosure and suppression markers remain strings and must not be treated as zero.","Area statistics only; not parcel values, appraisals, comparable sales, or cash-rent data."]},{"name":"getServiceInfo","description":"Return verified dimensions, auth, attribution, limits, and excluded capabilities.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"loadedAt","notes":"Follows NASS survey publication and Quick Stats load times."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Agricultural statistics are not parcel appraisals, comparable sales, rents, or soil-productivity measures.","Current exact cash-rent dimensions were not verified and are intentionally excluded.","Published disclosure and suppression markers remain strings and must not be treated as zero."]}]},"caveats":["Agricultural statistics are not parcel appraisals, comparable sales, rents, or soil-productivity measures.","Current exact cash-rent dimensions were not verified and are intentionally excluded.","Published disclosure and suppression markers remain strings and must not be treated as zero."]}