API Indonesia logoAPI Indonesia

Core Products

More Products

See All APIs
New

Realtime Earthquake API

BMKG earthquake data, updated hourly.

Learn more
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.

Sign Up FreeView Full Docs
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

[ 05 of 07 ]·Pricing
Simple Pricing

Choose a plan
by volume

Start with a one-time 3,000 credit bonus at signup (Rp3,000, granted after email verification), with no monthly allowance. Upgrade to Pro or Business, or buy pay as you go credits when you need a one-time top-up. One credit equals Rp1, and the price is per product per hit: a successful public data request costs 2 credits. A failed hit is free. Payments are processed through Sumopod.

Yearly saves 2 months

Prefer marketplace billing?Subscribe via RapidAPI

Do you want to skip subscriptions? Top up credits once from the dashboard and use them until they run out. One credit equals Rp1: a successful public data request costs 2 credits (Rp2), and a failed request is never charged.

Open dashboard

Free

For trying the API and early integration.

IDR 0/month
One-time 3,000 credit bonus (Rp3,000) at signup
Start for free
  • Access to every endpoint
  • 10 req/sec rate limit
  • API key created instantly
  • Best-effort email support

Pro

Most popular

For projects that are starting to get real usage.

IDR 49,000/month
50,000 credits (Rp50,000)
Subscribe
  • Every public data endpoint
  • 20 req/sec rate limit
  • 2 credits per successful public data request (Rp2)
  • Priority email support

Business

For production apps with higher traffic.

IDR 149,000/month
250,000 credits (Rp250,000)
Subscribe
  • Small-to-mid production credits
  • 60 req/sec rate limit
  • Priority support
  • Room for custom limits

Custom

For high volume, SLA, or company contracts.

From / month
IDR 500,000
Limit by agreement
Discuss needs
  • Custom volume and rate limit
  • SLA and company invoice
  • Priority support
  • Technical onboarding
[ 08 of 08 ]·FAQ
Frequently Asked

Answers Before
You Get Started

Quick answers to common questions about getting started, the signup bonus, API key security, data sources, and Sumopod billing.

API Indonesia is a REST API service for Indonesian public data: administrative regions down to village and postal code level, public holidays, prayer times, schools, universities, hospitals, and realtime earthquake data from BMKG — all through a single API key.
Fully self-service: sign up, create an API key in the dashboard, and start calling endpoints with the x-api-key header. No manual verification, no sales calls — you can make your first request within minutes.
Yes. API keys are stored as SHA-256 hashes so they are never persisted in their original form, and all traffic runs exclusively over HTTPS. If a key is ever exposed, you can rotate or revoke it at any time straight from the dashboard.
Every new account gets a one-time 3,000 credit bonus (Rp3,000), granted once the email is verified. With Google or GitHub signup it lands right away, because the provider already verified the email. There is no monthly free allowance on any plan tier, and the bonus never expires. Once the balance runs out, you can upgrade to Pro or Business or top up pay as you go credits from the dashboard.
One credit equals Rp1, and the price is per product per hit: a successful public data request costs 2 credits (Rp2). Only successful hits consume a balance: failed requests, validation errors, and timeouts are never charged, so you only pay for data you actually receive.
Upgrade straight from the dashboard with payment through Sumopod. Pro at IDR 49,000 gives 50,000 credits (Rp50,000, equal to 25,000 public data requests) and 20 requests per second; Business at IDR 149,000 gives 250,000 credits (Rp250,000, equal to 125,000 requests) and 60 requests per second. One credit equals Rp1 and a successful public data request costs 2 credits. If you do not want a subscription, you can also buy pay as you go credits. Yearly billing saves 2 months.
All data comes from official sources: Permendagri for regions, SK Menpan for public holidays, Kemenag for prayer times, Dapodik Kemdikbud and Dikti for education, SIRS Kemenkes for hospitals, and BMKG for earthquakes (required attribution: "Data sourced from BMKG"). Data is refreshed as the official sources publish updates; earthquake data is available in realtime.
Yes. API Indonesia runs on Cloudflare's edge network with 99.9% uptime and sub-100ms response latency. This distributed infrastructure keeps the API fast and reliable for production workloads — from fintech KYC to high-traffic e-commerce checkouts.
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