Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.climatifai.com/llms.txt

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

Climatifai (also known as AgroRisk API) is an agricultural risk intelligence API for Latin America. It combines climate baselines, satellite fire data, and crop-specific requirements to help you evaluate where and when to grow, what risks to watch, and how conditions are projected to change. The API covers the major agricultural zones of LATAM, excluding Brazil for most endpoints.

​
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 the country_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.