Developers & Public API
The API is free and open — call it directly, no key needed. mukoko weather runs on a set of public JSON endpoints with no account and no auth. The weather, air quality, geo lookup and search routes (/v1/weather, /v1/air-quality, /v1/air-quality/grid, /v1/geo and /v1/search) are served with Access-Control-Allow-Origin: *, so you can call them straight from the browser, cross-origin, from any site or app. The other routes (location lookup, nearest airports) answer our own sites only: call them from your server. All coordinates are WGS 84 decimal degrees; all timestamps are ISO 8601. Want a drop-in widget instead of raw JSON? See the embed page.
Base URL
The weather data endpoints (/v1/…) are served by our own edge API:
https://weather-api.mukoko.comThe embeddable widget's endpoint (/api/embed/current) is on the production site:
https://weather.mukoko.comCurrent weather (embed)
GET /api/embed/current — a compact current-conditions payload built for widgets. Pass a slug or lat & lon. With no parameters it returns weather for the visitor's own location, derived from their IP.
# Visitor's local weather (IP-based)
curl "https://weather.mukoko.com/api/embed/current"
# A specific location by slug
curl "https://weather.mukoko.com/api/embed/current?slug=harare"
# Explicit coordinates
curl "https://weather.mukoko.com/api/embed/current?lat=-17.83&lon=31.05"Response shape:
{
"location": { "name": "Harare", "province": "Harare",
"slug": "harare", "country": "ZW" },
"current": { "temp": 24, "feelsLike": 23, "code": 2,
"condition": "Partly cloudy", "high": 27, "low": 14,
"humidity": 55, "windSpeed": 9, "windDirection": "SE",
"isDay": true },
"daily": [ { "date": "2026-06-30", "day": "Today", "code": 2,
"condition": "Partly cloudy", "high": 27, "low": 14,
"precipitationProbability": 0 } /* up to 7 */ ],
"source": "ip",
"attribution": { "name": "mukoko weather",
"url": "https://weather.mukoko.com/harare" }
}Full forecast
GET /v1/weather?lat=&lon= — the complete forecast: current conditions plus hourly and 7-day daily arrays. The baseline is an Africa-weighted blend of nine global models (ECMWF IFS and AIFS weighted highest, then NOAA GFS, DWD ICON, the UK Met Office, CMA, ECCC GEM, Météo-France ARPEGE and JMA), served only when at least four of them answer. Add &model= (for example ecmwf_ifs) to base the forecast on one model instead, and &models= (a comma list of ecmwf_ifs,ecmwf_aifs025_single,gfs_seamless,icon_global,gem_global,meteofrance_arpege_world) for a Windy-style multi-model comparison. A next-hour precipitation nowcast (minutely, four 15-minute steps) is attached automatically when available.
# Full forecast for Harare
curl "https://weather-api.mukoko.com/v1/weather?lat=-17.83&lon=31.05"
# With a multi-model comparison
curl "https://weather-api.mukoko.com/v1/weather?lat=-17.83&lon=31.05&models=gfs_seamless,ecmwf_ifs"
# Based on a single model
curl "https://weather-api.mukoko.com/v1/weather?lat=-17.83&lon=31.05&model=ecmwf_ifs"The response carries headers that tell you which provider served what: X-Weather-Provider (the forecast baseline — open-meteo:blend / open-meteo:<model> / open-meteo:best_match / met-no / fallback; met-no is MET Norway's forecast, served only while Open-Meteo is unavailable, with baseline.reason failover, UV as a clear-sky index and no past hours; fallback is the seasonal estimate), X-Enrichment (whether Tomorrow.io insights were merged — tomorrow / skipped-budget / skipped-error / none) and X-Current-Source (origin of the current block, which may be stationkit when a nearby weather station is in range, or nea in Singapore, where the National Environment Agency's open data on data.gov.sg corrects it; the payload then carries current_overlay with the stations used, and the Singapore Open Data Licence notice must be shown with it).
Nearest location (geo lookup)
GET /v1/geo?lat=&lon= — resolves coordinates to a place (name, slug, province, country), anywhere on Earth. Handy for turning a device GPS fix into a place.
curl "https://weather-api.mukoko.com/v1/geo?lat=-17.83&lon=31.05"Location lookup & search
GET /v1/locations?slug= fetches a single location by slug. GET /v1/search?q= runs a text search across supported locations.
# Look up a location by slug
curl "https://weather-api.mukoko.com/v1/locations?slug=harare"
# Search locations by name
curl "https://weather-api.mukoko.com/v1/search?q=nairobi"Air quality
GET /v1/air-quality?lat=&lon= — the EPA-standard Air Quality Index (0–500) plus a seven-pollutant breakdown (PM2.5, PM10, O₃, NO₂, SO₂, CO, NH₃), and whether the air is better, worse or similar than at this hour yesterday (trend).
curl "https://weather-api.mukoko.com/v1/air-quality?lat=-17.83&lon=31.05"Nearest airports
GET /v1/airports/nearest?lat=&lon=&count= — the N nearest ICAO airports, each with its code, name, and distance in kilometres, sorted closest-first. count defaults to 5 (max 20).
curl "https://weather-api.mukoko.com/v1/airports/nearest?lat=-17.83&lon=31.05&count=3"AI endpoints
mukoko also runs AI-powered weather summaries and a Shamwari-branded chatbot backend. These are rate-limited and evolve quickly, so we don't document their internals here.
API keys (optional)
You never need a key for the public endpoints above. API keys are an optional extra for registered developers who want higher rate limits and named attribution for their traffic. Creating a key requires signing in.
Sign in to create and manage API keys. It's free — keys just unlock higher limits for registered developers.
Sign in to create an API keyTerms & fair use
These endpoints are free to use — weather is a public good. They are rate-limited per IP to keep the service healthy for everyone, so cache responses where you can and avoid hammering them in tight loops. Please keep the attribution back to mukoko weather when you display our data, and credit the model providers: forecasts come from ECMWF, NOAA, DWD, ECCC, Météo-France, the UK Met Office, CMA and JMA via Open-Meteo (CC BY 4.0), with insights enrichment from Tomorrow.io. While Open-Meteo is unavailable a forecast may come from MET Norway (CC BY 4.0, converted to our format). For a ready-made UI, use the embeddable widget.