# Climatifai API

> Agricultural risk intelligence API for Latin America — crop scoring, climate data, and fire monitoring.

## Docs

- [GET /agri/advisor — Crop aptitude score](https://docs.climatifai.com/api/agri-advisor.md): Score a specific crop's agricultural aptitude at any LATAM location using climate baselines, soil moisture, fire exposure, and biophysical suitability factors.
- [GET /agri/climate — Climate series and projections](https://docs.climatifai.com/api/agri-climate.md): Retrieve monthly historical climate data and CMIP6 future projections for any LATAM location, including temperature, precipitation, and soil moisture.
- [GET /agri/geocode — Search LATAM locations](https://docs.climatifai.com/api/agri-geocode.md): Search for LATAM locations by name using Open-Meteo Geocoding and retrieve coordinates, administrative details, elevation, and population for each result.
- [GET /agri/soil — Soil properties for a location](https://docs.climatifai.com/api/agri-soil.md): GET api.climatifai.com/agri/soil returns soil pH and texture data for a LATAM coordinate. SoilGrids integration is in progress; current responses include null values.
- [GET /fires/hotspots — Active fire hotspots](https://docs.climatifai.com/api/fires-hotspots.md): Retrieve active fire hotspots near a location from NASA FIRMS, with configurable search radius, look-back period, and satellite data source.
- [GET /fires/risk — Aggregated fire risk score](https://docs.climatifai.com/api/fires-risk.md): GET /fires/risk returns a 0–100 fire risk score and Alto/Medio/Bajo label based on NASA FIRMS hotspot density within a configurable radius.
- [Climatifai GraphQL API overview](https://docs.climatifai.com/api/graphql-overview.md): The Climatifai GraphQL API provides all REST capabilities plus crop comparison, agroclimatic alerts, and RAG context in a single flexible endpoint.
- [Climatifai GraphQL query reference](https://docs.climatifai.com/api/graphql-queries.md): Complete reference for all Climatifai GraphQL queries — arguments, return types, and copy-paste examples for advisor, climate, fires, alerts, and more.
- [GET /health — API status check](https://docs.climatifai.com/api/health.md): Verify that the Climatifai / AgroRisk API is reachable and accepting requests. Returns HTTP 200 with status ok when the service is up.
- [GET /support/programs — Government programs](https://docs.climatifai.com/api/support-programs.md): List all government agricultural support programs or retrieve a specific program by ID using the Climatifai /support/programs endpoints.
- [Authenticate with Climatifai API](https://docs.climatifai.com/authentication.md): Learn how access control works for the Climatifai API, including public endpoints, CORS configuration, and upstream API key handling.
- [Climate data: historical series and projections](https://docs.climatifai.com/concepts/climate-data.md): Understand how AgroRisk retrieves, caches, and serves monthly climate data from Open-Meteo ERA5 archives and CMIP6 scenario projections.
- [How crop aptitude scoring works](https://docs.climatifai.com/concepts/crop-scoring.md): Learn how AgroRisk combines seven climate and soil factors into a single 0–100 aptitude score for any supported crop and location.
- [Fire risk: hotspots and risk scoring](https://docs.climatifai.com/concepts/fire-risk.md): Learn how AgroRisk fetches NASA FIRMS satellite fire detections and converts hotspot density and intensity into an actionable 0–100 risk score.
- [Geographic coverage and location handling](https://docs.climatifai.com/concepts/locations.md): Understand AgroRisk's LATAM coverage, how coordinates are resolved and cached, and which countries and regions are supported across all endpoints.
- [Monitor agroclimatic alerts across LATAM zones](https://docs.climatifai.com/guides/alerts.md): Use the GraphQL alerts query to automatically monitor eight key LATAM agricultural zones for fire, heat waves, drought, and heavy rainfall in a single request.
- [Fetch historical and projected climate data](https://docs.climatifai.com/guides/climate-analysis.md): Retrieve monthly temperature, precipitation, and soil moisture series for any LATAM coordinate, including CMIP6 future projections across four SSP scenarios.
- [Score crop aptitude for any LATAM location](https://docs.climatifai.com/guides/crop-advisor.md): Step-by-step guide to scoring a crop's aptitude with the AgroRisk advisor, from choosing coordinates and crop ID to reading the factor breakdown.
- [Detect and assess fire risk near your location](https://docs.climatifai.com/guides/fire-monitoring.md): Query NASA FIRMS fire hotspots and get an aggregated risk score for any LATAM coordinate, with control over radius, lookback days, and satellite source.
- [Climatifai API: Agricultural Risk Intelligence for LATAM](https://docs.climatifai.com/introduction.md): Access crop aptitude scores, historical and CMIP6 climate data, NASA FIRMS fire hotspots, and agroclimatic alerts for Latin America.
- [Get started with Climatifai API](https://docs.climatifai.com/quickstart.md): Make your first Climatifai API calls in four steps: verify the API, score a crop's aptitude, fetch fire hotspots, and explore the GraphQL playground.