API Reference

Air Quality

List only readings cached today; city lookup returns the latest reading, which may be older.

Main endpoint
GET https://use.apiindonesia.id/api/v1/kualitas-udara
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
Data source
Per-reading source is in source: BMKG-CAMS or AQICN/WAQI. Check cached_at and updated_at before treating readings as current.
Product Brief

What this API gives you

List only readings cached today; city lookup returns the latest reading, which may be older.

Per-reading source is in source: BMKG-CAMS or AQICN/WAQI. Check cached_at and updated_at before treating readings as current.

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/kualitas-udara

List may be empty.

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.

  • Monitor city readings while checking cache time.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/kualitas-udara" -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{ "success": true, "data": [] }

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

Air Quality API questions

Where does air-quality data come from?

Each reading states its source in the source field: BMKG-CAMS or AQICN/WAQI.

What is the difference between the list and city endpoints?

GET /api/v1/kualitas-udara returns only readings cached today. GET /api/v1/kualitas-udara/{city} returns the latest reading for that city, which may be older.

How do I know a reading is current?

Check cached_at and updated_at in the response before showing a reading as current conditions.

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