What you can do
Score crop aptitude for any location. Submit a latitude, longitude, crop ID, and season, and the API returns a 0–100 aptitude score backed by seven weighted factors: rainfall adequacy, temperature fit, soil moisture, biophysical suitability (GAEZ proxy), soil pH compatibility, fire exposure, and a historical yield proxy. Scores come with a text recommendation in Spanish and a per-factor breakdown. The API supports 17 crops, including maiz, trigo, cafe, soya, frijol, papa, arroz, cana, tomate, and more. Access historical and projected climate data. The/agri/climate endpoint returns monthly temperature, precipitation, and soil moisture series from Open-Meteo for any historical range, paired with a CMIP6 future projection (default scenario: SSP3-7.0). This data feeds the scoring engine and is also available for direct use in dashboards or models.
Monitor active fire hotspots. The /fires/hotspots endpoint proxies NASA FIRMS VIIRS data for a configurable radius (default 100 km) and lookback window of 1–5 days. You can also request an aggregated fire risk score (0–100, labeled Alto / Medio / Bajo) at /fires/risk.
Receive live agroclimatic alerts. The GraphQL alerts query checks 8 key agricultural zones across LATAM in parallel — from the Orinoquía and Chaco to the Bajío and Pampa Húmeda — and surfaces fire, heat wave, drought, and heavy rain alerts in near-real time.
Two interfaces
The API exposes both a REST interface and a GraphQL interface. REST endpoints under/agri, /fires, and /support follow standard GET conventions with query parameters. The GraphQL interface at /graphql exposes the full feature set — including crop comparison and RAG-powered context retrieval — through a single endpoint with an interactive GraphiQL playground.
Geographic focus
All location-based endpoints work anywhere in Latin America. Most endpoints are designed for the region excluding Brazil; location data stored via optional database caching is restricted to non-Brazilian LATAM countries (ISO 3166-1 alpha-2 codes accepted with thecountry_iso parameter).
Get started
Quickstart
Make your first API call in under five minutes.
Crop scoring
Understand how aptitude scores are calculated.
Agri advisor endpoint
Full parameter reference for
/agri/advisor.