Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalogue, 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 catalogue yet?

Yes, through the community Discord, on any tier.

Wilayah Indonesia

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

6 endpoints248 calls2/6 passing

Get API key

Provinces

All 38 Indonesian provinces with their official BPS codes.

GET/v1/indonesia:wilayah/provinces

failed last check1d cache

Parameters

No parameters. Call it as is.

Example response

{"project":"indonesia:wilayah",  "data": {"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"  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Regencies & Cities

Regencies and cities of one province, typed KABUPATEN or KOTA.

GET/v1/indonesia:wilayah/regencies

failed last check1d cache

Parameters

Name	Type	In	Description
provinceCode	string	query	BPS province code, 2 digits, from the provinces endpoint. BPS and Kemendagri codes differ for the six Papua provinces. Required.
year	number	query	Registry year. Data exists for 2014-2026; a region is absent from years before it was formed.

Example response

{"project":"indonesia:wilayah",  "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"  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Districts

Districts (kecamatan) of one regency or city.

GET/v1/indonesia:wilayah/districts

failed last check1d cache

Parameters

Name	Type	In	Description
regencyCode	string	query	BPS regency/city code, 4 digits, from the regencies endpoint. Required.
year	number	query	Registry year. Data exists for 2014-2026; a region is absent from years before it was formed.

Example response

{"project":"indonesia:wilayah",  "data": {"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"  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Villages

Villages (desa/kelurahan) of one district.

GET/v1/indonesia:wilayah/villages

failed last check1d cache

Parameters

Name	Type	In	Description
districtCode	string	query	BPS district code, 7 digits, from the districts endpoint. Required.
year	number	query	Registry year. Data exists for 2014-2026; a region is absent from years before it was formed.

Example response

{"project":"indonesia:wilayah",  "data": {"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"  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Search

Search regions by name across all four levels; returns BPS and Kemendagri codes.

GET/v1/indonesia:wilayah/search

passing · 2.4s1d cache

Parameters

Name	Type	In	Description
q	string	query	Region name, at least 2 characters. Matches names only, never codes. SQL wildcards work: % for any run of characters, _ for exactly one. Required.

Example response

{"project":"indonesia:wilayah",  "data": {"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  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code Bridging

BPS code, Kemendagri code and postal code for every region under one parent.

GET/v1/indonesia:wilayah/bridging

passing · 0.6s1d cache

Parameters

Name	Type	In	Description
level	enum	query	Level to list. Items carry both the BPS code and the Kemendagri code, which differ for the six Papua provinces. One of province, regency, district, village. Required.
parentCode	string	query	BPS code of the parent — 2 digits for regencies, 4 for districts, 7 for villages. Omit for level=province.

Example response

{"project":"indonesia:wilayah",  "data": {"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"  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Try it

Live request with your key

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

Wilayah Indonesia

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

6 endpoints248 calls2/6 passing

Get API key

All 38 Indonesian provinces with their official BPS codes.

GET/v1/…wilayah/provinces

failed last check1d cache

Try it

Parameters

No parameters. Call it as is.

Example response

{"project":"indonesia:wilayah",  "data": {"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"  },"timestamp":"2026-09-02T07:32:13Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code

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