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