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.

llms.txt

Provinces

All 38 Indonesian provinces with their official BPS codes.

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

Provinces

index.ts

// 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);

Recommended · typed errors, safe retries and bulk jobsSDK reference

Full reference

6 endpoints · plain text

GET

Provinces/v1/indonesia:wilayah/provinces

0 params

All 38 Indonesian provinces with their official BPS codes.

Parameters

This endpoint takes no parameters.

Request

curl -X GET "https://api.zapi.ink/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"
}

GET

Regencies & Cities/v1/indonesia:wilayah/regencies

2 params

Regencies 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.zapi.ink/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"
}

GET

Districts/v1/indonesia:wilayah/districts

2 params

Districts (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.zapi.ink/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"
}

GET

Villages/v1/indonesia:wilayah/villages

2 params

Villages (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.zapi.ink/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"
}

GET

Search/v1/indonesia:wilayah/search

1 param

Search 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.zapi.ink/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
}

GET

Code Bridging/v1/indonesia:wilayah/bridging

2 params

BPS 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.zapi.ink/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" }

Provinces

Code

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

Provinces

Code

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