API Reference

Weather Forecast

3-day weather forecast from BMKG for all villages across Indonesia. Data is fetched on demand and cached for 6 hours. Use the village code (adm4) from the Regions endpoint.

Main endpoint
GET https://use.apiindonesia.id/api/v1/cuaca
Endpoints
2
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

3-day weather forecast from BMKG for all villages across Indonesia. Data is fetched on demand and cached for 6 hours. Use the village code (adm4) from the Regions endpoint.

Coverage
2

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

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

Returns a 3-day weather forecast for a single village. Choose between adm4 (village code) or kabupaten_id to fetch a representative forecast for the regency.

When should you use it?

The Weather Forecast API fits logistics, travel, events, agriculture, and local apps that need BMKG forecasts down to village/sub-district level.

Users choose a village/sub-district, then the app shows a 3-day forecast.

Field operations need weather context before deliveries, harvests, or events.

The product wants caching so upstream calls stay controlled.

Use village codes from the Regions API. If your input is GPS coordinates, map them to the matching administrative area first.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Logistics & agriculture: plan deliveries or harvest activity around local weather forecasts.
  • Travel & event apps: display weather forecasts for destinations or event locations.
  • Precision farming: adjust irrigation/planting schedules using village-level forecasts.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/cuaca?adm4=32.73.01.1001" \\
  -H "x-api-key: YOUR_API_KEY"
Response · 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"
    }
  ]
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Weather Forecast API questions

How many days of forecast are available?

A 3-day BMKG forecast for villages across Indonesia. Data is fetched on demand and cached for 6 hours.

Which location code do I use?

Use adm4 (village code, e.g. 32.73.01.1001) or kabupaten_id for a representative forecast of a regency/city. If you do not know the code, search with GET /api/v1/cuaca/search?q=bandung.

Which fields does a forecast contain?

Among others: weather condition (Indonesian and English), temperature, humidity, cloud cover, precipitation, wind direction and speed, and visibility, per local time slot.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization