Developer API & Integration Docs

Public Data Gateway

Programmatic access to NASA Earth observations, ISRIC soil profiles, and crop rotation suitability scoring for researchers, agricultural extension platforms, and partners.

Protocol

REST / JSON (v1)

HTTPS TLS 1.3

Public Rate Limit

60 req / min

Anonymous client IP tier

Resolution

~50 km Gridded Cell

NASA POWER global grid

Core Gateway Endpoints

GET/v1/climate?lat=24.3745&lon=88.6042

Climate Summary (NASA POWER)

Fetches gridded annual precipitation, temperature extremes, and seasonal onset shift for the 50 km cell.

Response Format (JSON)

{
  "state": "live",
  "source": "NASA POWER Climatology",
  "updatedAt": "2026-10-24T06:00:00Z",
  "data": {
    "gridLat": 24.5,
    "gridLon": 88.5,
    "annualPrecipMm": 1625,
    "extremeHeatDays": 42,
    "monsoonOnsetShiftDays": 12,
    "signalCodes": ["lower_rainfall_trend", "later_monsoon_onset"]
  }
}

GET/v1/soil?lat=24.3745&lon=88.6042

Soil Baseline (ISRIC SoilGrids & SMAP)

Returns root-zone soil moisture percentiles, organic carbon fraction, and pH for the field.

Response Format (JSON)

{
  "state": "live",
  "source": "ISRIC SoilGrids & NASA SMAP",
  "updatedAt": "2026-10-24T06:00:00Z",
  "data": {
    "organicCarbonPercent": 0.68,
    "ph": 5.8,
    "rootZoneMoistureVol": 0.18,
    "textureClass": "sandy_loam",
    "signalCodes": ["depleted_soil_organic_matter", "dry_season_water_deficit"]
  }
}

POST/v1/rotations/rank

Rotation Ranking Engine

Ranks candidate 3-season crop rotations based on farmer priorities (water, income, soil).

Response Format (JSON)

{
  "state": "live",
  "source": "FarmScale Scoring Engine v1.0",
  "updatedAt": "2026-10-24T06:00:00Z",
  "data": {
    "topRotations": [
      {
        "rank": 1,
        "id": "mustard-mungbean-aman",
        "score": 7.4,
        "crops": ["mustard", "mungbean", "aman_rice"],
        "whyCodes": ["low_water_demand_winter", "legume_nitrogen_boost"]
      }
    ]
  }
}

Authentication and Key Policy

Public endpoints for educational and smallholder decision-support require no API keys. High-volume institutional and extension partner integrations are provisioned through the separate Developer Admin Console.