Skip to main content
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>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt

Use this file to discover all available pages before exploring further.

GET https://www.wiseyield.co/api/v1/crop-library/search
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.
curl 'https://www.wiseyield.co/api/v1/crop-library/search?q=tomato&maxDaysToMaturity=120' \
  -H "Authorization: Bearer $WISEYIELD_API_KEY"

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