Referensi API

Prakiraan Cuaca

Prakiraan cuaca 3 hari dari BMKG untuk seluruh desa/kelurahan di Indonesia. Data diambil on-demand lalu di-cache selama 6 jam. Gunakan kode desa (adm4) dari endpoint Wilayah.

Endpoint utama
GET https://use.apiindonesia.id/api/v1/cuaca
Jumlah endpoint
2
Autentikasi
Header x-api-key (buat gratis di dashboard)
Harga
2 kredit (Rp2) per request sukses; request gagal gratis
Format
JSON (REST), contoh cURL, JavaScript, Python
Ringkasan Produk

Apa yang Anda dapat dari API ini

Prakiraan cuaca 3 hari dari BMKG untuk seluruh desa/kelurahan di Indonesia. Data diambil on-demand lalu di-cache selama 6 jam. Gunakan kode desa (adm4) dari endpoint Wilayah.

Cakupan
2

endpoint siap pakai dalam produk ini, dengan respons JSON dan pola error yang konsisten.

Akses
API key

Bisa dicoba dengan bonus 3.000 kredit saat daftar, lalu dipakai di production lewat satu API key API Indonesia.

Contoh resource
https://use.apiindonesia.id/api/v1/cuaca

Mengembalikan prakiraan cuaca 3 hari untuk satu desa/kelurahan. Pilih antara adm4 (kode desa) atau kabupaten_id untuk mengambil data perwakilan kabupaten.

Kapan API ini layak dipakai?

API Prakiraan Cuaca cocok untuk logistik, travel, event, agrikultur, dan aplikasi lokal yang perlu prakiraan BMKG sampai level desa atau kelurahan.

Pengguna memilih desa atau kelurahan, lalu aplikasi menampilkan prakiraan 3 hari.

Operasional lapangan perlu melihat cuaca sebelum pengiriman, panen, atau acara.

Produk ingin memakai cache agar panggilan ke sumber data tetap terkendali.

Gunakan kode desa dari API Wilayah. Jika input Anda berupa koordinat GPS, petakan dulu ke wilayah administratif yang sesuai.

Contoh skenario produk

Bagian ini membedakan halaman produk dari dokumentasi. Dokumentasi menjawab cara memanggil endpoint; halaman ini menjawab kenapa endpoint tersebut masuk akal untuk fitur Anda.

  • Logistik & agrikultur: rencanakan pengiriman atau aktivitas panen berdasarkan prakiraan cuaca lokal.
  • Aplikasi travel & event: tampilkan prakiraan cuaca tujuan wisata atau lokasi acara.
  • Pertanian presisi: sesuaikan jadwal irigasi/tanam dengan prakiraan cuaca desa spesifik.

Contoh Pemakaian

Request
curl "https://use.apiindonesia.id/api/v1/cuaca?adm4=32.73.01.1001" \\
  -H "x-api-key: YOUR_API_KEY"
Respons · 200 OK
{
  "data": [
    {
      "id": "w_327301100120260706010000",
      "adm4": "32.73.01.1001",
      "provinsi": "Jawa Barat",
      "kotkab": "Kota Bandung",
      "kecamatan": "Sukasari",
      "desa": "Isola",
      "datetime": "2026-07-06T01:00:00",
      "local_datetime": "2026-07-06 08:00:00",
      "weather": "Cerah",
      "weather_code": "0",
      "weather_desc": "Cerah Berawan",
      "weather_desc_en": "Partly Cloudy",
      "temperature_c": 29,
      "humidity_percent": 62,
      "cloud_cover_percent": 2,
      "precipitation_mm": 0,
      "wind_direction": "E",
      "wind_direction_to": "W",
      "wind_direction_degrees": 125,
      "wind_speed": 3.5,
      "visibility_m": 15060,
      "visibility_text": "> 10 km",
      "analysis_date": "2026-07-05T12:00:00",
      "source": "BMKG"
    }
  ]
}

Artikel Terkait

Harga 2 kredit (Rp2) per request sukses; request gagal gratis. Bonus 3.000 kredit sekali saat daftar, tanpa kartu kredit dan tanpa jatah bulanan.

Pertanyaan seputar API Prakiraan Cuaca

Berapa hari prakiraan cuaca yang tersedia?

Prakiraan 3 hari dari BMKG untuk desa/kelurahan di seluruh Indonesia. Data diambil saat diminta lalu di-cache selama 6 jam.

Kode lokasi apa yang dipakai?

Gunakan adm4 (kode desa, contoh 32.73.01.1001) atau kabupaten_id untuk prakiraan perwakilan satu kabupaten/kota. Jika belum tahu kodenya, cari lewat GET /api/v1/cuaca/search?q=bandung.

Field apa saja yang ada di prakiraan?

Antara lain kondisi cuaca (bahasa Indonesia dan Inggris), suhu, kelembapan, tutupan awan, curah hujan, arah dan kecepatan angin, serta jarak pandang, per jam lokal.

Mulai Sekarang

Mulai Integrasi
Hari Ini

Daftar gratis dan dapatkan bonus 3.000 kredit (Rp3.000) setelah email diverifikasi, ambil API key, lalu langsung call endpoint pertama Anda. Tanpa kartu kredit, tanpa proses approval yang ribet.

Visualisasi gelombang titik