Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalog, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn't in the catalog yet?

Yes, through the community Discord, on any tier.

Why are Pro and Ultra marked Soon?

Checkout is not open yet. The limits and features listed on those tiers are already built and enforced — what is pending is billing, not the product.

Wilayah Indonesia

Indonesian administrative regions — province, regency, district and village — from official government registries, with BPS and Kemendagri codes.

Endpoints: 6
Requests: 222
Updated: 3 hours ago
For LLMs: llms.txt

Endpoint healthnot yet measured

provincesnot measured
regenciesnot measured
districtsnot measured
villagesnot measured
searchnot measured

+ 1 more endpoint

no measurements yetdaily 01:00 WIB

Playground

6 endpoints

GET/v1/indonesia:wilayah/provinces1d cache0 paramschecking key…

Parameters

Response

EXAMPLE

{
  "count": 38,
  "items": [
    {
      "code": "11",
      "name": "ACEH"
    },
    {
      "code": "12",
      "name": "SUMATERA UTARA"
    },
    {
      "code": "13",
      "name": "SUMATERA BARAT"
    },
    {
      "code": "14",
      "name": "RIAU"
    },
    {
      "code": "15",
      "name": "JAMBI"
    },
    {
      "code": "16",
      "name": "SUMATERA SELATAN"
    },
    {
      "code": "17",
      "name": "BENGKULU"
    },
    {
      "code": "18",
      "name": "LAMPUNG"
    }
  ],
  "provider": "sipedas"
}

Code examples

Provinces

zpi-sdkrecommended

// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("indonesia:wilayah", "provinces", {});
console.log(data);

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/provinces" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

6 endpoints · plain text

GETProvinces/v1/indonesia:wilayah/provincesAll 38 Indonesian provinces with their official BPS codes.

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/provinces" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 38,
  "items": [
    {
      "code": "11",
      "name": "ACEH"
    },
    {
      "code": "12",
      "name": "SUMATERA UTARA"
    },
    {
      "code": "13",
      "name": "SUMATERA BARAT"
    },
    {
      "code": "14",
      "name": "RIAU"
    },
    {
      "code": "15",
      "name": "JAMBI"
    },
    {
      "code": "16",
      "name": "SUMATERA SELATAN"
    },
    {
      "code": "17",
      "name": "BENGKULU"
    },
    {
      "code": "18",
      "name": "LAMPUNG"
    }
  ],
  "provider": "sipedas"
}

GETRegencies & Cities/v1/indonesia:wilayah/regenciesRegencies and cities of one province, typed KABUPATEN or KOTA.

Parameters

provinceCodestringrequired: BPS province code, 2 digits, from the provinces endpoint. BPS and Kemendagri codes differ for the six Papua provinces.
yearnumberoptional: Registry year. Data exists for 2014-2026; a region is absent from years before it was formed.

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/regencies?provinceCode=32&year=2026" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "year": 2026,
  "count": 27,
  "items": [
    {
      "code": "3201",
      "name": "BOGOR",
      "type": "KABUPATEN"
    },
    {
      "code": "3202",
      "name": "SUKABUMI",
      "type": "KABUPATEN"
    },
    {
      "code": "3203",
      "name": "CIANJUR",
      "type": "KABUPATEN"
    },
    {
      "code": "3204",
      "name": "BANDUNG",
      "type": "KABUPATEN"
    },
    {
      "code": "3205",
      "name": "GARUT",
      "type": "KABUPATEN"
    },
    {
      "code": "3206",
      "name": "TASIKMALAYA",
      "type": "KABUPATEN"
    },
    {
      "code": "3207",
      "name": "CIAMIS",
      "type": "KABUPATEN"
    },
    {
      "code": "3208",
      "name": "KUNINGAN",
      "type": "KABUPATEN"
    }
  ],
  "provider": "sipedas",
  "provinceCode": "32"
}

GETDistricts/v1/indonesia:wilayah/districtsDistricts (kecamatan) of one regency or city.

Parameters

regencyCodestringrequired: BPS regency/city code, 4 digits, from the regencies endpoint
yearnumberoptional: Registry year. Data exists for 2014-2026; a region is absent from years before it was formed.

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/districts?regencyCode=3204&year=2026" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "year": 2026,
  "count": 31,
  "items": [
    {
      "code": "3204010",
      "name": "CIWIDEY"
    },
    {
      "code": "3204011",
      "name": "RANCABALI"
    },
    {
      "code": "3204020",
      "name": "PASIRJAMBU"
    },
    {
      "code": "3204030",
      "name": "CIMAUNG"
    },
    {
      "code": "3204040",
      "name": "PANGALENGAN"
    },
    {
      "code": "3204050",
      "name": "KERTASARI"
    },
    {
      "code": "3204060",
      "name": "PACET"
    },
    {
      "code": "3204070",
      "name": "IBUN"
    }
  ],
  "provider": "sipedas",
  "regencyCode": "3204"
}

GETVillages/v1/indonesia:wilayah/villagesVillages (desa/kelurahan) of one district.

Parameters

districtCodestringrequired: BPS district code, 7 digits, from the districts endpoint
yearnumberoptional: Registry year. Data exists for 2014-2026; a region is absent from years before it was formed.

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/villages?districtCode=3204280&year=2026" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "year": 2026,
  "count": 6,
  "items": [
    {
      "code": "3204280001",
      "name": "BOJONGSARI"
    },
    {
      "code": "3204280002",
      "name": "BOJONGSOANG"
    },
    {
      "code": "3204280003",
      "name": "LENGKONG"
    },
    {
      "code": "3204280004",
      "name": "CIPAGALO"
    },
    {
      "code": "3204280005",
      "name": "BUAHBATU"
    },
    {
      "code": "3204280006",
      "name": "TEGALLUAR"
    }
  ],
  "provider": "sipedas",
  "districtCode": "3204280"
}

GETSearch/v1/indonesia:wilayah/searchSearch regions by name across all four levels; returns BPS and Kemendagri codes.

Parameters

qstringrequired: Region name, at least 2 characters. Matches names only, never codes. SQL wildcards work: % for any run of characters, _ for exactly one.

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/search?q=bojong%25soang" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 2,
  "items": [
    {
      "code": "3204280",
      "name": "BOJONGSOANG",
      "level": "district",
      "kodeDagri": "32.04.08",
      "namaDagri": "BOJONGSOANG"
    },
    {
      "code": "3204280002",
      "name": "BOJONGSOANG",
      "level": "village",
      "kodeDagri": "32.04.08.2002",
      "namaDagri": "BOJONGSOANG"
    }
  ],
  "query": "bojong%soang",
  "provider": "sig-bps",
  "truncated": false
}

GETCode Bridging/v1/indonesia:wilayah/bridgingBPS code, Kemendagri code and postal code for every region under one parent.

Parameters

levelenumrequired: Level to list. Items carry both the BPS code and the Kemendagri code, which differ for the six Papua provinces. Values: province, regency, district, village.
parentCodestringoptional: BPS code of the parent — 2 digits for regencies, 4 for districts, 7 for villages. Omit for level=province.

Request

curl -X GET "https://api.zpi.web.id/v1/indonesia:wilayah/bridging?level=village&parentCode=3204280" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 6,
  "items": [
    {
      "code": "3204280001",
      "name": "BOJONGSARI",
      "type": "DESA",
      "kodePos": "40354",
      "kodeDagri": "32.04.08.2005",
      "namaDagri": "BOJONGSARI"
    },
    {
      "code": "3204280002",
      "name": "BOJONGSOANG",
      "type": "DESA",
      "kodePos": "40354",
      "kodeDagri": "32.04.08.2002",
      "namaDagri": "BOJONGSOANG"
    },
    {
      "code": "3204280003",
      "name": "LENGKONG",
      "type": "DESA",
      "kodePos": "40354",
      "kodeDagri": "32.04.08.2001",
      "namaDagri": "LENGKONG"
    },
    {
      "code": "3204280004",
      "name": "CIPAGALO",
      "type": "DESA",
      "kodePos": "40354",
      "kodeDagri": "32.04.08.2004",
      "namaDagri": "CIPAGALO"
    },
    {
      "code": "3204280005",
      "name": "BUAHBATU",
      "type": "DESA",
      "kodePos": "40354",
      "kodeDagri": "32.04.08.2003",
      "namaDagri": "BUAHBATU"
    },
    {
      "code": "3204280006",
      "name": "TEGALLUAR",
      "type": "DESA",
      "kodePos": "40354",
      "kodeDagri": "32.04.08.2006",
      "namaDagri": "TEGALLUAR"
    }
  ],
  "level": "village",
  "provider": "sig-bps",
  "parentCode": "3204280"
}

{ "count": 38, "items": [ { "code": "11", "name": "ACEH" }, { "code": "12", "name": "SUMATERA UTARA" }, { "code": "13", "name": "SUMATERA BARAT" }, { "code": "14", "name": "RIAU" }, { "code": "15", "name": "JAMBI" }, { "code": "16", "name": "SUMATERA SELATAN" }, { "code": "17", "name": "BENGKULU" }, { "code": "18", "name": "LAMPUNG" } ], "provider": "sipedas" }

// npm i zpi-sdk import { ZpiClient } from "zpi-sdk"; const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" }); const data = await client.run("indonesia:wilayah", "provinces", {}); console.log(data);

{ "year": 2026, "count": 27, "items": [ { "code": "3201", "name": "BOGOR", "type": "KABUPATEN" }, { "code": "3202", "name": "SUKABUMI", "type": "KABUPATEN" }, { "code": "3203", "name": "CIANJUR", "type": "KABUPATEN" }, { "code": "3204", "name": "BANDUNG", "type": "KABUPATEN" }, { "code": "3205", "name": "GARUT", "type": "KABUPATEN" }, { "code": "3206", "name": "TASIKMALAYA", "type": "KABUPATEN" }, { "code": "3207", "name": "CIAMIS", "type": "KABUPATEN" }, { "code": "3208", "name": "KUNINGAN", "type": "KABUPATEN" } ], "provider": "sipedas", "provinceCode": "32" }

{ "year": 2026, "count": 31, "items": [ { "code": "3204010", "name": "CIWIDEY" }, { "code": "3204011", "name": "RANCABALI" }, { "code": "3204020", "name": "PASIRJAMBU" }, { "code": "3204030", "name": "CIMAUNG" }, { "code": "3204040", "name": "PANGALENGAN" }, { "code": "3204050", "name": "KERTASARI" }, { "code": "3204060", "name": "PACET" }, { "code": "3204070", "name": "IBUN" } ], "provider": "sipedas", "regencyCode": "3204" }

{ "year": 2026, "count": 6, "items": [ { "code": "3204280001", "name": "BOJONGSARI" }, { "code": "3204280002", "name": "BOJONGSOANG" }, { "code": "3204280003", "name": "LENGKONG" }, { "code": "3204280004", "name": "CIPAGALO" }, { "code": "3204280005", "name": "BUAHBATU" }, { "code": "3204280006", "name": "TEGALLUAR" } ], "provider": "sipedas", "districtCode": "3204280" }

{ "count": 2, "items": [ { "code": "3204280", "name": "BOJONGSOANG", "level": "district", "kodeDagri": "32.04.08", "namaDagri": "BOJONGSOANG" }, { "code": "3204280002", "name": "BOJONGSOANG", "level": "village", "kodeDagri": "32.04.08.2002", "namaDagri": "BOJONGSOANG" } ], "query": "bojong%soang", "provider": "sig-bps", "truncated": false }

{ "count": 6, "items": [ { "code": "3204280001", "name": "BOJONGSARI", "type": "DESA", "kodePos": "40354", "kodeDagri": "32.04.08.2005", "namaDagri": "BOJONGSARI" }, { "code": "3204280002", "name": "BOJONGSOANG", "type": "DESA", "kodePos": "40354", "kodeDagri": "32.04.08.2002", "namaDagri": "BOJONGSOANG" }, { "code": "3204280003", "name": "LENGKONG", "type": "DESA", "kodePos": "40354", "kodeDagri": "32.04.08.2001", "namaDagri": "LENGKONG" }, { "code": "3204280004", "name": "CIPAGALO", "type": "DESA", "kodePos": "40354", "kodeDagri": "32.04.08.2004", "namaDagri": "CIPAGALO" }, { "code": "3204280005", "name": "BUAHBATU", "type": "DESA", "kodePos": "40354", "kodeDagri": "32.04.08.2003", "namaDagri": "BUAHBATU" }, { "code": "3204280006", "name": "TEGALLUAR", "type": "DESA", "kodePos": "40354", "kodeDagri": "32.04.08.2006", "namaDagri": "TEGALLUAR" } ], "level": "village", "provider": "sig-bps", "parentCode": "3204280" }

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Al-Qur'an Kemenag

Jadwal Sholat & Hijriah

Perpusnas

Bimas Islam Kemenag

Cek BPOM

Cek NIK

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Al-Qur'an Kemenag

Jadwal Sholat & Hijriah

Perpusnas

Bimas Islam Kemenag

Cek BPOM

Cek NIK