Quran

Quran data with surahs, verse metadata, signed audio links, reciters, and random verse lookup.

Quran Surahs

GET/api/v1/quran/surahs

Retrieve the list of all Quran surahs with metadata and page ranges.

---

Query Parameters

Parameter	Type	Description
api_key *	string	Your API key, or use the X-API-Key header.

---

Try Quran Surahs

Try Quran Surahs

Fetch all Quran surahs from the API using your API key.

API Key *Your API key to authenticate the request.

GET /api/v1/quran/surahs?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/quran/surahs?api_key=YOUR_KEY"

---

Get a Single Surah

GET/api/v1/quran/surah/{number}

Return one surah by number, including metadata, page range, and the full verse list. Each verse includes signed audio links when available.

---

Query Parameters

Parameter	Type	Description
api_key *	string	Your API key, or use the X-API-Key header.
lang	string	Filter verse text by language: arabic, english, or bengali.
reciter	string	Filter the verse audio results by reciter name.
pageNumber	integer	Page number for verse pagination. Defaults to 1.
pageSize	integer	Number of verses per page. Defaults to 20.

---

URL Parameters

Parameter	Type	Description
number *	integer	Surah number between 1 and 114.

---

Try Get Surah By Number

Try Quran Surah by Number

Fetch a single surah by its number using your API key.

Surah Number *Surah number between 1 and 114.

Page Number Page number for verse pagination.

Page Size Number of verses per page.

API Key *Used as the api_key query parameter.

GET /api/v1/quran/surah/{number}?api_key=YOUR_KEY&pageNumber=1&pageSize=20

Example Request

curl "https://your-domain.com/api/v1/quran/surah/1?api_key=YOUR_KEY"

---

Get Available Reciters

GET/api/v1/quran/reciters

List available Quran audio reciters for Arabic, English, and Bengali audio.

---

Try Quran Reciters

Try Quran Reciters

List available Quran reciters for each supported language.

API Key *Your API key to authenticate the request.

GET /api/v1/quran/reciters?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/quran/reciters?api_key=YOUR_KEY"

---

Get a Quran Verse by ID

GET/api/v1/quran/verse/{id}

Return verse metadata, position details, and signed audio links for available reciters.

---

Query Parameters

Parameter	Type	Description
api_key *	string	Your API key, or use the X-API-Key header.
lang	string	Filter text by language: arabic, english, or bengali.
reciter	string	Filter audio by reciter name, e.g. alafasy.

---

Try Quran Verse by ID

Try Quran Verse by ID

Fetch a specific verse with metadata and signed audio links.

Verse ID *Verse ID as 6 digits (surah + verse).

Language Optional language filter: arabic, english, bengali.

Reciter Optional reciter filter to return only a single audio source.

API Key *Used as the api_key query parameter.

GET /api/v1/quran/verse/001001?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/quran/verse/001001?api_key=YOUR_KEY&lang=english&reciter=alafasy"

---

Get Quran Verse Audio Only

GET/api/v1/quran/verse/{id}/audio

Return signed audio links only for a specific verse ID.

---

Try Quran Verse Audio

Try Quran Verse Audio

Fetch signed audio URLs for a verse without verse text.

Verse ID *Verse ID as 6 digits (surah + verse).

Reciter Optional reciter filter for one audio source.

API Key *Used as the api_key query parameter.

GET /api/v1/quran/verse/001001/audio?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/quran/verse/001001/audio?api_key=YOUR_KEY"

---

Get Random Quran Verse

GET/api/v1/quran/verse/random

Return a random Quran verse with signed audio links.

---

Try Random Quran Verse

Try Random Quran Verse

Fetch a random Quran verse from the API.

API Key *Your API key to authenticate the request.

GET /api/v1/quran/verse/random?api_key=YOUR_KEY

Example Request

curl "https://your-domain.com/api/v1/quran/verse/random?api_key=YOUR_KEY"

---

Notes

• Audio URLs are generated at request time and signed for secure delivery.
• Signed audio URLs include expires and signature query parameters.
• Expiration duration is controlled by MEDIA_EXPIRED_TIME in the environment.
• Use lang to filter verse text and reciter to filter audio results.