QuranJS

Audio API

Access Quran audio recitations from different reciters.

The Audio API provides access to audio recitations including chapter audio and verse-by-verse audio with timing.

Chapter Recitations

Get All Chapter Recitations

const recitations = await client.audio.findAllChapterRecitations("2");

console.log(recitations[0]);
// {
//   id: 1,
//   chapterId: 1,
//   fileSize: 12345,
//   format: "mp3",
//   audioUrl: "https://audio.quran.com/...",
//   duration: 120
// }

ChapterRecitation Type

Prop

Type

Get Specific Chapter

const audio = await client.audio.findChapterRecitationById("2", "1");

console.log(`URL: ${audio.audioUrl}`);
console.log(`Duration: ${audio.duration}s`);

Verse Recitations

By Chapter

const { audioFiles, pagination } = await client.audio.findVerseRecitationsByChapter(
  "1",  // Chapter ID
  "2"   // Recitation ID
);

audioFiles.forEach((audio) => {
  console.log(`${audio.verseKey}: ${audio.url}`);
});

VerseRecitation Type

Prop

Type

By Verse Key

const { audioFiles } = await client.audio.findVerseRecitationsByKey(
  "2:255",
  "2"
);

const audio = audioFiles[0];
console.log(`URL: ${audio.url}`);
console.log(`Duration: ${audio.duration}s`);

Field Selection

const { audioFiles } = await client.audio.findVerseRecitationsByChapter("1", "2", {
  fields: {
    url: true,
    duration: true,
    segments: true,
    format: false,
  },
});

Last updated on