Climatifai GraphQL API overview

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

Query	Description
`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
`alerts`	Live 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
    }
  }
}

​Endpoint

​Design

​Available queries

​GraphiQL playground

​Basic usage

Endpoint

Design

Available queries

GraphiQL playground

Basic usage