QuranJS

Resources API

Access metadata about translations, tafsirs, reciters, and languages.

The Resources API provides metadata about translations, tafsirs, reciters, and other Quranic resources.

Recitations

Get All Recitations

const recitations = await client.resources.findAllRecitations();

recitations.forEach((r) => {
  console.log(`${r.id}. ${r.reciterName} (${r.style})`);
});

RecitationResource Type

Prop

Type

Get Recitation Details

const info = await client.resources.findRecitationInfo("2");

console.log(info.reciterName);
console.log(info.bio);
console.log(info.photo);

RecitationInfoResource Type

Prop

Type

Translations

Get All Translations

const translations = await client.resources.findAllTranslations();

const english = translations.filter((t) => t.languageName === "english");
const urdu = translations.filter((t) => t.languageName === "urdu");

TranslationResource Type

Prop

Type

Get Translation Details

const info = await client.resources.findTranslationInfo("131");

console.log(info.name);
console.log(info.authorName);
console.log(info.languageName);
console.log(info.bio);

TranslationInfoResource Type

Prop

Type

Tafsirs

Get All Tafsirs

const tafsirs = await client.resources.findAllTafsirs();

tafsirs.forEach((t) => {
  console.log(`${t.name} by ${t.authorName}`);
});

TafsirResource Type

Prop

Type

Get Tafsir Details

const info = await client.resources.findTafsirInfo("171");

console.log(info.name);       // "Tafsir Ibn Kathir"
console.log(info.authorName); // "Ibn Kathir"
console.log(info.bio);

TafsirInfoResource Type

Prop

Type

Languages

const languages = await client.resources.findAllLanguages();

languages.forEach((lang) => {
  console.log(`${lang.name} (${lang.iso}): ${lang.translationsCount} translations`);
});

LanguageResource Type

Prop

Type

Chapter Resources

Chapter Information

const chapterInfos = await client.resources.findAllChapterInfos();

chapterInfos.forEach((info) => {
  console.log(`${info.name} - ${info.languageName}`);
});

ChapterInfoResource Type

Prop

Type

Chapter Reciters

const reciters = await client.resources.findAllChapterReciters();

reciters.forEach((r) => {
  console.log(`${r.name} (${r.arabicName})`);
});

ChapterReciterResource Type

Prop

Type

Recitation Styles

const styles = await client.resources.findAllRecitationStyles();

console.log(styles.murattal);  // Murattal reciters
console.log(styles.mujawwad);  // Mujawwad reciters

RecitationStylesResource Type

Prop

Type

Verse Media

const media = await client.resources.findVerseMedia();

console.log(media.unicode); // Font URL
console.log(media.image);   // Images base URL
console.log(media.audio);   // Audio base URL

VerseMediaResource Type

Prop

Type

Last updated on