Verses API
Retrieve Quran verses with translations, tafsirs, audio, and word-by-word analysis.
The Verses API provides access to Quranic verses with support for translations, tafsirs, audio, and word analysis.
Get Verse by Key
const verse = await client.verses.findByKey("2:255");
const firstVerse = await client.verses.findByKey("1:1");
const lastVerse = await client.verses.findByKey("114:6");
Verse Type
Prop
Type
With Translations
const verse = await client.verses.findByKey("2:255", {
translations: [20, 131], // English and Urdu
words: true,
translationFields: {
text: true,
languageName: true,
resourceName: true,
},
});
With Audio
const verse = await client.verses.findByKey("1:1", {
reciter: 2,
words: true,
});
With Tafsir
const verse = await client.verses.findByKey("1:1", {
tafsirs: [171],
translations: [20],
});
Get Verses by Chapter
const verses = await client.verses.findByChapter("1");
const paginated = await client.verses.findByChapter("2", {
translations: [20],
perPage: 10,
page: 1,
words: true,
});
Get Verses by Page
const firstPage = await client.verses.findByPage("1");
const page42 = await client.verses.findByPage("42", {
translations: [131],
});
Get Verses by Divisions
// By Juz
const juz1 = await client.verses.findByJuz("1");
// By Hizb
const hizb1 = await client.verses.findByHizb("1");
// By Rub
const rub1 = await client.verses.findByRub("1");
Get Random Verse
const random = await client.verses.findRandom({
translations: [20],
words: true,
});
Field Selection
Word Fields
const verse = await client.verses.findByKey("1:1", {
words: true,
wordFields: {
textUthmani: true,
transliteration: true,
translation: true,
audio: true,
},
});
Translation Fields
const verse = await client.verses.findByKey("2:255", {
translations: [20, 131],
translationFields: {
text: true,
languageName: true,
resourceName: true,
},
});
Verse Fields
const verse = await client.verses.findByKey("1:1", {
fields: {
textUthmani: true,
textUthmaniTajweed: true,
pageNumber: true,
juzNumber: true,
},
});
Pagination
const verses = await client.verses.findByChapter("2", {
page: 1,
perPage: 20,
translations: [20],
});
Last updated on