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.

The Climatifai API exposes a GraphQL endpoint at /graphql, powered by Strawberry and FastAPI. It supports everything the REST API offers — crop advisor scores, climate series, fire hotspots, fire risk, and geocoding — plus three capabilities exclusive to GraphQL: side-by-side crop comparison, live agroclimatic alerts for eight LATAM zones, and semantic document search via RAG context. You can select exactly the fields you need in a single request, which is particularly useful when building dashboards or mobile clients where bandwidth matters.

​
Endpoint

POST api.climatifai.com/graphql
Send all GraphQL operations as HTTP POST requests with a JSON body containing a query string (and optionally variables). You can also open GET api.climatifai.com/graphql in a browser to access the GraphiQL IDE, an in-browser playground where you can explore the schema, run queries interactively, and inspect field-level documentation.

​
Design

All operations are queries (read-only). The schema exposes no mutations or subscriptions — every call retrieves data without modifying state.

​
Available queries

QueryDescription
advisor(lat, lon, cropId, season)Agricultural aptitude score for a crop at a location
climate(lat, lon, from, to, scenario)Historical climate baseline and CMIP6 projections
hotspots(lat, lon, radiusKm, days, source)Active NASA FIRMS fire hotspots near a point
fireRisk(lat, lon, radiusKm)Aggregated 0–100 fire risk score
compare(lat, lon, cropIdA, cropIdB, season)Side-by-side comparison of two crops with a winner
alertsLive agroclimatic alerts for 8 key LATAM zones
geocode(q, count)Place search for LATAM regions
ragContext(query, limit)Semantic search over agroclimatic documents
For the full argument list, return types, and copy-paste examples for each query, see the Query Reference.

​
GraphiQL playground

Open GET /graphql in a browser to access the interactive GraphiQL IDE. It auto-completes field names and arguments, displays inline schema documentation, and lets you run queries against the live API without writing any code. 
https://api.climatifai.com/graphql

​
Basic usage

Send a POST request with Content-Type: application/json and a body containing your query string.
cURL
curl --request POST \
  --url "https://api.climatifai.com/graphql" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "{ fireRisk(lat: 19.4326, lon: -99.1332, radiusKm: 100) { riskScore riskLabel hotspotCount } }"
  }'
Response
{
  "data": {
    "fireRisk": {
      "riskScore": 42.7,
      "riskLabel": "Medio",
      "hotspotCount": 5
    }
  }
}