API V1.3

Versioned Islamic data built for automation

6,236 Quran verses and the same published tool data, with checksums, stable contracts and revocable keys.

Quick start

Ask the site owner to create a project and key.
Keep the key in an environment variable or secure credential store.
Send it only in the Authorization header.

curl -H 'Authorization: Bearer $QURANREELS_API_KEY' \
  'https://quranreels.tech/api/v1/adhkar?collection=adhkar&category=morning&per_page=5'

Never expose the key in public JavaScript, URLs or query strings.

Available capabilities

القرآن / Quran

114 سورة و6,236 آية وبحث ونطاقات محلية

quran:read

مصادر البيانات / Datasets

الإصدار والبصمة والمصدر لكل حزمة

catalog:read

الأذكار / Adhkar

فئات وبحث وقراءة عنصر

adhkar:read

مخارج الحروف / Makharij

حروف ومخارج ومقارنة

makharij:read

التلاوات / Recitations

بحث وفلاتر وروابط استماع

recitations:read

الأسماء / Names

بحث بالاسم والمعنى والأصل

names:read

إذاعة القرآن / Radio

محطات وبحث وروابط بث

radio:read

كاشف الحلال / Halal

تحليل نص المكونات بالأسباب

halal:analyze

Method	Endpoint	Scope
`GET`	`/api/v1/tools`	`catalog:read`
`GET`	`/api/v1/tools/{tool_id}`	`catalog:read`
`GET`	`/api/v1/datasets`	`catalog:read`
`GET`	`/api/v1/datasets/{dataset_id}`	`catalog:read`
`GET`	`/api/v1/quran/surahs`	`quran:read`
`GET`	`/api/v1/quran/surahs/{surah_id}`	`quran:read`
`GET`	`/api/v1/quran/verses/{surah_id}/{ayah}`	`quran:read`
`GET`	`/api/v1/quran/range`	`quran:read`
`GET`	`/api/v1/quran/search`	`quran:read`
`GET`	`/api/v1/adhkar/categories`	`adhkar:read`
`GET`	`/api/v1/adhkar`	`adhkar:read`
`GET`	`/api/v1/adhkar/random`	`adhkar:read`
`GET`	`/api/v1/adhkar/{dhikr_id}`	`adhkar:read`
`GET`	`/api/v1/makharij/letters`	`makharij:read`
`GET`	`/api/v1/makharij/letters/{letter_id}`	`makharij:read`
`GET`	`/api/v1/makharij/points`	`makharij:read`
`GET`	`/api/v1/makharij/compare`	`makharij:read`
`GET`	`/api/v1/recitations`	`recitations:read`
`GET`	`/api/v1/recitations/{recitation_id}`	`recitations:read`
`GET`	`/api/v1/names`	`names:read`
`GET`	`/api/v1/names/{name_id}`	`names:read`
`GET`	`/api/v1/radio/stations`	`radio:read`
`GET`	`/api/v1/radio/stations/{station_id}`	`radio:read`
`POST`	`/api/v1/halal/analyze`	`halal:analyze`
`GET`	`/api/v1/halal/knowledge/version`	`halal:analyze`
`GET`	`/api/v1/halal/ingredients/{ingredient_id}`	`halal:analyze`
`POST`	`/api/v1/halal/analyze/batch`	`halal:analyze`
`GET`	`/api/v1/halal/analyze/batch/{job_id}`	`halal:analyze`
`GET`	`/api/v1/account/usage`	`authenticated`

Response envelope

{"data":[...],"pagination":{"page":1,"per_page":25,"total":31,"has_more":true},"data_version":"2026-09-12.2"}

Errors include a stable code and request_id. Respect Retry-After for 429 and retry 503 later.

Python

import os, requests
r = requests.get(
  "https://quranreels.tech/api/v1/radio/stations",
  headers={"Authorization": "Bearer " + os.environ["QURANREELS_API_KEY"]},
  timeout=15,
)
r.raise_for_status()
print(r.json())

Node.js

const r = await fetch("https://quranreels.tech/api/v1/names?q=نور", {
  headers: {Authorization: `Bearer ${process.env.QURANREELS_API_KEY}`}
});
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());

Quotas and usage

Default: 1,000 requests/day and 30/minute per developer across projects. The owner may increase this within the safety ceiling.

Every religious response includes a trust block with its real source, version and review state. Halal responses expose their reasoning and support short-lived asynchronous batches of 1–20 items; analysis is not certification.