# Al-Qur'an Kemenag API

> Al-Qur'an Kemenag API on Apizie: 6 endpoints (Daftar Surat, Detail Surat, Daftar Ayat, Detail Ayat, …) returned as clean JSON through one API key. 6 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/indonesia:quran-kemenag/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `indonesia:quran-kemenag`
- Category: Indonesia
- Status: live
- Source: https://quran.kemenag.go.id
- Page: https://zieapi.vercel.app/api/indonesia/quran-kemenag
- OpenAPI: https://zieapi.vercel.app/api/indonesia/quran-kemenag/openapi.json

Teks Arab, latin, terjemahan, audio, dan tafsir Al-Qur'an versi Kemenag. Data diambil dari API publik equran.id (v2).

## Endpoints

### Daftar Surat
`GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/surah-list`

| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | no | Filter nama latin / arti surat |
| revelation | string | no |  |
| page | integer | no |  |
| count | integer | no |  |

### Detail Surat
`GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/surah-detail`

| Parameter | Type | Required | Description |
|---|---|---|---|
| surah | integer | yes | Nomor surat (1–114) |

### Daftar Ayat
`GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/ayah-list`

| Parameter | Type | Required | Description |
|---|---|---|---|
| surah | integer | yes | Nomor surat (1–114) |
| page | integer | no |  |
| count | integer | no |  |

### Detail Ayat
`GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/ayah-detail`

| Parameter | Type | Required | Description |
|---|---|---|---|
| surah | integer | yes | Nomor surat (1–114) |
| ayah | integer | yes | Nomor ayat |

### Tafsir Ayat
`GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/tafsir-ayah`

| Parameter | Type | Required | Description |
|---|---|---|---|
| surah | integer | yes | Nomor surat (1–114) |
| ayah | integer | no | Nomor ayat (opsional) |

### Ayat Acak
`GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/random-ayah`

| Parameter | Type | Required | Description |
|---|---|---|---|
| surah | integer | no | Batasi ke surat ini (opsional) |

## Example
```
curl "https://zieapi.vercel.app/v1/indonesia:quran-kemenag/surah-list" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Al-Qur'an Kemenag API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/indonesia:quran-kemenag/surah-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Al-Qur'an Kemenag API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Al-Qur'an Kemenag API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key indonesia:quran-kemenag.

### What is the status of the Al-Qur'an Kemenag API?
Live: works with just an Apizie key