BMKG Indonesia Weather Forecast API – Village Level (3-day, 3-hourly)

Official BMKG weather forecasts for any of 83,000+ Indonesian villages (desa/kelurahan) — temperature, rain, humidity, wind, cloud cover and visibility every 3 hours for 3 days, in English and Indonesian. Just type a place name like Ubud, Gianyar, Kuta, Badung or Kemayoran, Jakarta Pusat — no need to look up region codes.

Perfect for logistics & delivery planning, agriculture, construction, tourism & villa operators, events, insurance, dashboards and AI agents that need hyper-local Indonesian weather.

Why this Actor

• Name → code lookup built in (Kepmendagri 2025 region codes for 83,762 villages). Enter a district name to get all its villages.
• Two output formats: one row per 3-hour slot (spreadsheets/BI) or one row per location with min/max temperature, rainy slots, first rain time and total precipitation + nested forecast (apps/LLMs).
• Respects BMKG's 60 requests/minute limit and retries automatically; failed locations are not charged.
• Attribution included in every row, as required by BMKG.

Output example (slots mode)

{
  "adm4": "51.04.05.1005", "village": "Ubud", "district": "Ubud", "regency": "Gianyar", "province": "Bali",
  "lat": -8.497, "lon": 115.264, "timezone": "Asia/Makassar",
  "localDatetime": "2026-10-20 17:00:00", "weatherEn": "Partly Cloudy", "weatherId": "Cerah Berawan",
  "temperatureC": 29, "humidityPct": 66, "precipitationMm": 0, "windSpeedKmh": 9.4, "windFrom": "SE",
  "cloudCoverPct": 58, "iconUrl": "https://api-apps.bmkg.go.id/storage/icon/cuaca/...svg",
  "source": "BMKG (Badan Meteorologi, Klimatologi, dan Geofisika)"
}

See samples/ for real output.

Input

Field	Description
locations	Village or district names; add regency/province after commas to disambiguate
adm4Codes	Or give codes directly, e.g. 31.71.03.1001
maxVillagesPerLocation	Expand a district name to up to N villages
outputMode	slots or locations
hoursAhead	Keep only the next N hours

Pricing (pay per event)

$2 per 1,000 location forecasts (event location-forecast; one location = ~20–24 three-hour slots). Schedule it twice a day (BMKG updates forecasts twice daily).

Data source & terms

Data: BMKG open data API (api.bmkg.go.id/publik/prakiraan-cuaca, documented at data.bmkg.go.id). BMKG requires that you credit BMKG as the data source in your app — the source field is included for this. Region names: Kepmendagri No. 300.2.2-2138/2025 via cahyadsn/wilayah (MIT). Not affiliated with BMKG.

Kata kunci: prakiraan cuaca BMKG, cuaca per desa, API cuaca Indonesia, weather Bali, weather Jakarta.