{"uid":"cap_PYv_nAFYMdJYs1o0wiqdP","slug":"2s-soil-profile-lookup-a84ef8bd","name":"2s Soil Profile Lookup","description":"Ground-truth soil profile for any US latitude/longitude from the USDA-NRCS SSURGO survey (Soil Data Access). Returns the soil map unit plus its component soil types ranked by composition percent, each with taxonomic order/class, drainage class, hydrologic group, and representative slope. Keyless, public-domain. Use for agronomy, land assessment, hydrology, septic/foundation suitability, and crop-fit reasoning. Coordinates over water or outside surveyed areas return an empty component list.","url":"https://2s.io/api/soil/profile","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"lat":42,"lon":-93.6}}},"response":{"data":{"ok":true,"items":[{"lat":42,"lon":-93.6,"components":[{"slopePct":1,"componentName":"Hanlon","drainageClass":"Moderately well drained","taxonomicClass":"Coarse-loamy, mixed, mesic Cumulic Hapludolls","taxonomicOrder":"Mollisols","hydrologicGroup":"A","componentPercent":60},{"slopePct":1,"componentName":"Spillville","drainageClass":"Moderately well drained","taxonomicClass":"Fine-loamy, mixed, mesic Cumulic Hapludolls","taxonomicOrder":"Mollisols","hydrologicGroup":"B/D","componentPercent":30},{"slopePct":1,"componentName":"Spillville","drainageClass":"Moderately well drained","taxonomicClass":"Fine-loamy, mixed, mesic Cumulic Hapludolls","taxonomicOrder":"Mollisols","hydrologicGroup":"B","componentPercent":5},{"slopePct":1,"componentName":"Coland","drainageClass":"Poorly drained","taxonomicClass":"Fine-loamy, mixed, superactive, mesic Cumulic Endoaquolls","taxonomicOrder":"Mollisols","hydrologicGroup":"C/D","componentPercent":5}],"mapUnitKey":"411278","mapUnitName":"Hanlon-Spillville complex, channeled, 0 to 2 percent slopes"}],"total":1,"source":{"url":"https://sdmdataaccess.nrcs.usda.gov/","license":"Public domain (US Government work). Live-wrapped.","provider":"USDA-NRCS Soil Data Access (SSURGO)"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"soil.profile","settlement":{"txHash":"0x12d933b112a4b639cbd75d31134cfedbd4f90d497e45b82f4830a7fc8452295b","network":"eip155:8453","success":true}}}},"exampleRequest":{"lat":42,"lon":-93.6},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NAHt93rRitIhIK5QB2ZkZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns USDA-NRCS SSURGO soil profile data (components, drainage, taxonomy, hydrologic group) for a given latitude/longitude coordinate.","exampleAgentPrompt":"What's the soil profile at latitude 42, longitude -93.6 — I need the soil components, drainage class, taxonomic order, and hydrologic group for that location.","exampleUseCases":null,"resultDescription":"Returns an array of map units at the given coordinates, each with soil components listing component name, slope percent, drainage class, taxonomic class and order, hydrologic group, and percent composition — plus the data source attribution from USDA-NRCS SSURGO.","failureModes":["Coordinates outside the US where SSURGO data is unavailable — returns empty items array","Invalid lat/lon values outside the valid range (-90 to 90 lat, -180 to 180 lon) — schema validation error","Coordinates in water bodies or areas with no mapped soil units — returns empty or null result","Payment failure via x402 if USDC balance is insufficient","Network timeout from upstream USDA SSURGO web service"],"whenToPreferThis":"Choose this endpoint when you need ground-truth USDA SSURGO soil classification data for a specific geographic point, especially for agricultural, environmental, construction, or land-use analysis. Ideal when you need soil taxonomy, drainage class, or hydrologic group at a coordinate without managing USDA API keys or authentication.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:07.969Z","isFirstParty":false}