curl 'https://www.wiseyield.co/api/v1/crop-library/search?q=tomato&maxDaysToMaturity=120' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
{
"data": [
{
"id": "<string>",
"name": "<string>",
"scientificName": {},
"category": "<string>",
"description": {},
"climateData": {},
"soilRequirements": {},
"managementData": {},
"growthData": {},
"yieldData": {},
"economicData": {},
"metadata": {},
"dataSource": "<string>",
"verificationStatus": "<string>",
"createdAt": "<string>"
}
]
}Crop Library
Search crops
Text + filter search over the admin crop catalog.
GET
/
api
/
v1
/
crop-library
/
search
curl 'https://www.wiseyield.co/api/v1/crop-library/search?q=tomato&maxDaysToMaturity=120' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
{
"data": [
{
"id": "<string>",
"name": "<string>",
"scientificName": {},
"category": "<string>",
"description": {},
"climateData": {},
"soilRequirements": {},
"managementData": {},
"growthData": {},
"yieldData": {},
"economicData": {},
"metadata": {},
"dataSource": "<string>",
"verificationStatus": "<string>",
"createdAt": "<string>"
}
]
}GET https://www.wiseyield.co/api/v1/crop-library/search
rejected on review — each row carries its own verificationStatus so you can decide how much weight to give it. Use this endpoint to discover crops; use Get crop details for the full record by ID.
Authentication
Requires a key with thelibrary:read scope. See Authentication.
Query parameters
All optional.string
Text search across name, scientific name, and localized names (Arabic, French, Spanish, German).
string
Category ID filter.
string
low, moderate, high, very_high.string
full_sun, partial_shade, shade.string
none, light, moderate, high.string
low, moderate, high.string
declining, stable, growing, high_growth.integer
Filter for crops maturing within N days.
string
default:"name"
name, daysToMaturity, yield.integer
default:"50"
1–100.
Response
array
Array of admin crop objects matching the query.
Show Admin crop
Show Admin crop
string
UUID.
string
Common name (English).
string | null
Binomial.
string
Category ID.
string | null
Free text.
object
Frost / drought tolerance, ideal temp range, rainfall needs.
object
Preferred soil types, pH range, drainage.
object
Water + sun requirements, fertilization schedule, pest pressure.
object
Days to maturity, growth stages, FAO-56 Kc coefficients.
object
Average yield per hectare, harvest windows.
object
Price ranges, demand trends, market signals.
object
Localized names, source citations, additional flags.
string
Original source (FAO, USDA, etc.).
string
One of
verified, under_review, unverified. Results never include rejected. Until 2026-07-29 this endpoint returned only verified rows, which had the perverse effect of excluding every crop carrying a source citation — those are the newest and best-sourced entries, and they enter the ladder at under_review. Treat this field as provenance, not as a quality filter.string
ISO 8601.
curl 'https://www.wiseyield.co/api/v1/crop-library/search?q=tomato&maxDaysToMaturity=120' \
-H "Authorization: Bearer $WISEYIELD_API_KEY"
Errors
| Status | When |
|---|---|
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks library:read scope |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |