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