Endpoint
Parameters
Identifier for the crop to score. The following canonical IDs are supported:
English aliases are also accepted and automatically resolved to the canonical ID:
maize, wheat, coffee, soybean, vineyard, bean, potato, rice, sugarcane, tomato, onion, garlic, sunflower, sorghum, cotton, quinoa, avocado.Season context for the score calculation. Accepted values:
lluvias (rainy season), secas (dry season), annual (full-year average).Optional ISO 3166-1 alpha-2 country code for the location being queried. Must be a LATAM country code, excluding Brazil (
BR). Examples: MX, CO, GT. Used by deployments with location tracking enabled; safe to omit for standard use.Response
Weighted aptitude score from 0 to 100. Calculated as the dot product of individual factor scores and their weights.
Human-readable aptitude tier derived from
score:"Alta"— score ≥ 70"Media"— score 45–69"Baja"— score < 45
Plain-language recommendation summarising the score, highlighting critical or attention-worthy factors, and suggesting management actions where relevant.
Cache metadata describing whether the underlying climate data was served from cache or fetched live.