{"name":"QuraanOnline API","version":"v1","description":"Open read API for the QuraanOnline platform (SOW 10.4). Free to use with attribution.","endpoints":[{"path":"/api/v1/meta","desc":"This document + content attribution"},{"path":"/api/v1/surahs","desc":"All 114 surahs with metadata"},{"path":"/api/v1/surahs/{id}","desc":"One surah with verses. Query: translations=en,ur,ml (default en), transliteration=1, audio=1"},{"path":"/api/v1/verses/{key}","desc":"One verse by key e.g. 2:255 — all languages, audio URL, word-by-word when available"},{"path":"/api/v1/search?q=","desc":"Keyword search (Arabic-normalised) across ar/en/ur/ml. Query: limit"},{"path":"/api/v1/word-by-word/{key}","desc":"Word-by-word gloss + morphology (full corpus)"},{"path":"/api/v1/root/{root}","desc":"Sarf research: every derived form of an Arabic root, grouped, with locations"},{"path":"/api/v1/random","desc":"A random verse"},{"path":"/api/v1/tafsir","desc":"Tafsir works catalogue (Amendment A1 compliant)"},{"path":"/api/v1/tafsir/{work}/{key}","desc":"Tafsir text for a verse"},{"path":"/api/v1/hadith","desc":"Hadith collections"},{"path":"/api/v1/hadith/{collection}?page=&q=","desc":"Paginated hadith with search"},{"path":"/api/v1/hadith/{collection}/{number}","desc":"One hadith (Arabic + English + grading)"},{"path":"/api/v1/seerah","desc":"Seerah timeline events"},{"path":"/api/v1/seerah/{slug}","desc":"One event with related verses"},{"path":"/api/v1/crosslinks?ref=&type=verse","desc":"Typed cross-link graph lookup"},{"path":"/api/v1/reciters","desc":"Recitation catalogue + local audio status"},{"path":"/api/v1/qiraat/{key}","desc":"Canonical readings comparison: Hafs, Warsh, Qaloon"}],"languages":["ar","en","ur","ml"],"attribution":{"generatedAt":"2026-07-25T17:47:51.829Z","note":"Development data. Re-verify every licence before production use (SOW Part 9.2).","orientationPolicy":"A1-R2: Salafi orientation only. Translation editions pinned and vetted: EN Saheeh International, UR Muhammad Junagarhi, ML Abdul Hameed Madani & Kunhi Mohammed. No Sufi, Shia, Ahmadiyya or madhhab-partisan content.","sources":[{"content":"Arabic text (Uthmani) + transliteration","source":"quran-json v3.1.2 (github.com/risan/quran-json), text originally from Tanzil.net","license":"Tanzil terms: free use with attribution, text must not be modified"},{"content":"English translation","source":"fawazahmed0/quran-api edition eng-ummmuhammad (Saheeh International)","license":"fawazahmed0/quran-api (Unlicense) — verify before production"},{"content":"Urdu translation","source":"fawazahmed0/quran-api edition urd-muhammadjunagar (Muhammad Junagarhi)","license":"fawazahmed0/quran-api (Unlicense) — verify before production"},{"content":"Malayalam translation","source":"fawazahmed0/quran-api edition mal-abdulhameedmada","author":"Abdul Hameed Madani And Kunhi Mohammed","license":"See fawazahmed0/quran-api (Unlicense) / alquran.cloud terms"},{"content":"Malayalam translation — Amani Moulavi (വിശുദ്ധ ഖുർആൻ വിവരണം)","source":"Extracted in-house from KNM print scans (archive.org/details/AmaniTafseer_201705, ayaathqhlc.com surah PDFs) via the SOW 9.3 digitization pipeline; per-verse boundaries partly heuristic, pending editorial verification","author":"Muhammad Amani Moulavi (d. 1987)","license":"NOT CLEARED: KNM/publisher permission required before any publication (SOW 9.2). Dev preview only."},{"content":"Tafsir — Amani Moulavi (വിശുദ്ധ ഖുർആൻ വിവരണം), Malayalam","source":"Same digitization pipeline (anchored spans, 99.82% verse coverage); enabled for dev preview 2026-07-26","author":"Muhammad Amani Moulavi (d. 1987)","license":"NOT CLEARED: KNM/publisher permission required before any publication (SOW 9.2). Dev preview only."},{"content":"Verse audio (linked at runtime, not stored)","source":"cdn.islamic.network (Al-Quran Cloud CDN), reciter Mishary Alafasy","license":"Free for non-commercial use with attribution"}]}}