Kesho AI Weather API

Version 2.0.0

Professional weather intelligence platform providing hyper-local meteorological data and AI-powered forecasts for East Africa. Access real-time conditions, historical data, and custom reports.

Quick Start

Base URL:

https://api.keshoai.com

JSON Responses

All endpoints return structured JSON

HTTP Status Codes

Appropriate status codes for all responses

AI-Powered

Advanced meteorological intelligence

API Endpoints

GET/api/health

Health check endpoint to verify API status and system information

EXAMPLE
curl https://api.keshoai.com/api/health
GET/api/v2/weather/current

Get current weather conditions for any location

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/current?lat=-1.2921&lng=36.8219&units=metric"
GET/api/v2/weather/forecast

Get detailed weather forecast up to 14 days

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/forecast?lat=-1.2921&lng=36.8219&days=7&units=metric"
GET/api/v2/weather/historical

Access historical weather data with AI insights

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/historical?lat=-1.2921&lng=36.8219&start_date=2024-01-01&end_date=2024-01-07"
GET/api/v2/weather/report

Generate comprehensive AI-powered weather reports

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/report?lat=-1.2864&lng=36.8172&report_type=comprehensive&ai_agriculture=true&ai_health=true"
GET/api/v2/weather/csv

Export weather data in CSV format with AI analysis

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/csv?lat=-1.2921&lng=36.8219&start_date=2024-01-01&end_date=2024-01-31&include_ai=true" -o weather_report.csv
GET/api/v2/weather/alerts

Get weather alerts and warnings for your location

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/alerts?lat=-1.2921&lng=36.8219"
GET/api/v2/weather/locations

Search and discover weather locations with enhanced data

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/locations?q=Nairobi&limit=10&include=current&sort=relevance"
          -H "X-API-Key: your_api_key_here"
GET/api/v2/weather/by-location

Get weather by location name with AI-powered insights

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/by-location?location=Dar%20es%20Salaam&units=metric&include_ai=true"
          -H "X-API-Key: your_api_key_here"
GET/api/v2/weather/current-location

GPS-based weather with intelligent location services

EXAMPLE
curl "https://api.keshoai.com/api/v2/weather/current-location?lat=-6.8235&lng=39.2695&include_address=true&units=metric"
          -H "X-API-Key: your_api_key_here"