Skip to main content
GET
The crop library is a shared, curated catalog of verified admin crops with climate, soil, growth, yield, management, and economic metadata. Use this endpoint to discover crops; use Get crop details for the full record by ID.

Authentication

Requires a key with the library:read scope. See Authentication.

Query parameters

All optional.
q
string
Text search across name, scientific name, and localized names (Arabic, French, Spanish, German).
category
string
Category ID filter.
waterRequirement
string
low, moderate, high, very_high.
sunRequirement
string
full_sun, partial_shade, shade.
frostTolerance
string
none, light, moderate, high.
droughtTolerance
string
low, moderate, high.
demandTrend
string
declining, stable, growing, high_growth.
maxDaysToMaturity
integer
Filter for crops maturing within N days.
sortBy
string
default:"name"
name, daysToMaturity, yield.
limit
integer
default:"50"
1–100.

Response

data
array
Array of admin crop objects matching the query.

Errors

StatusWhen
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks library:read scope
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error