Al Quran Cloud

The Qur'an, from Al Quran Cloud: the full Arabic text with 118 translations in 49 languages, six commentaries, three transliterations and 190 recitations. Get a single verse, a whole chapter, one of the 30 juz or a page of the printed mushaf, search every verse for a word or a phrase, and get a verse of the day that is the same for everyone all day. Every verse comes back in Arabic and in the translation you choose, with a link to the recitation when you want one. No account or API key required.

Actions

Action	What it does
Get a chapter	Get a whole chapter of the Qur'an, verse by verse, in Arabic and in the translation you pick.
Get a juz	Get one of the 30 juz, the parts the Qur'an is divided into for reading a day at a time through Ramadan, in Arabic and in the translation you pick.
Get a page	Get one page of the printed Qur'an, the 604-page mushaf everyone reads from, in Arabic and in the translation you pick.
Get a verse	Get one verse of the Qur'an by chapter and number, in Arabic and in the translation you pick, with a recitation of it if you want one.
Get the verse of the day	Get one verse chosen for today, drawn from all 6,236.
List chapters	List the Qur'an's 114 chapters in order, each with its name, what the name means, how many verses it holds and where it was revealed.
List the verses of prostration	Get all 15 verses at which a prostration is made, each saying whether it is obligatory or recommended, in Arabic and in the translation you pick.
List translations and recitations	See what Al Quran Cloud publishes: 118 translations in 49 languages, six Arabic commentaries, three transliterations and 190 recitations.
Search the Qur'an	Find every verse containing a word or phrase, across the whole Qur'an or within one chapter.

Get a chapter

Get a whole chapter of the Qur'an, verse by verse, in Arabic and in the translation you pick. Choose a reciter and you also get the recording: one file for the chapter, or one per verse, depending on how that reciter recorded it. Ask for a few verses at a time to read a long chapter over several days. No API key required.

Inputs

ChapterchaptertextRequired: Which of the Qur'an's 114 chapters (surahs).One of: 1 (1. Al-Faatiha (The Opening)), 2 (2. Al-Baqara (The Cow)), 3 (3. Aal-i-Imraan (The Family of Imraan)), 4 (4. An-Nisaa (The Women)), 5 (5. Al-Maaida (The Table)), 6 (6. Al-An'aam (The Cattle)), 7 (7. Al-A'raaf (The Heights)), 8 (8. Al-Anfaal (The Spoils of War)), 9 (9. At-Tawba (The Repentance)), 10 (10. Yunus (Jonas)), and 104 more.
Translationtranslationtext: Which translation to return alongside the Arabic. 118 translations in 49 languages, plus commentaries and transliterations. Saheeh International (English) if you leave it alone.Default: en.sahih.
Reciterrecitertext: Optional. Adds a link to a recording. A reciter marked 'whole chapter' gives one recording of the chapter; one marked 'verse by verse' gives a recording per verse. Leave empty if you don't need audio.
Number of verseslimitnumber: Optional. Leave empty for the whole chapter, which is what this usually wants. Set it to take a chapter a few verses at a time.From 1 to 1000.
Skipoffsetnumber: Optional. How many verses to skip before this page. Use the next offset from the previous result to carry on where it stopped.At least 0. Default: 0.

Outputs

chapterobject: The chapter this step fetched.
countnumber: How many records are in this page.
has_moretrue/false: Whether more remain after this page.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
reciterobject: The reciter that was chosen, or null if none was.
total_countnumber: How many there are in total, before paging.
translationobject: The translation these verses came back in.
verseslist: The verses of the chapter.

Example output

{
  "chapter": {
    "audio_url": "https://cdn.islamic.network/quran/audio-surah/128/ar.alafasy/2.mp3",
    "name": "Al-Baqara",
    "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
    "name_meaning": "The Cow",
    "number": 2,
    "revealed_in": "Medinan",
    "url": "https://alquran.cloud/surah/2",
    "verse_count": 286
  },
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "reciter": {
    "direction": null,
    "id": "ar.alafasy",
    "kind": "verse_audio",
    "kind_label": "Recitation, verse by verse",
    "language": "ar",
    "language_name": "Arabic",
    "name": "Alafasy",
    "native_name": "\u0645\u0634\u0627\u0631\u064a \u0627\u0644\u0639\u0641\u0627\u0633\u064a"
  },
  "total_count": 286,
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  },
  "verses": [
    {
      "arabic": "\u0671\u0644\u0644\u064e\u0651\u0647\u064f \u0644\u064e\u0622 \u0625\u0650\u0644\u064e\u0670\u0647\u064e \u0625\u0650\u0644\u064e\u0651\u0627 \u0647\u064f\u0648\u064e \u0671\u0644\u0652\u062d\u064e\u0649\u064f\u0651 \u0671\u0644\u0652\u0642\u064e\u064a\u064f\u0651\u0648\u0645\u064f",
      "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/262.mp3",
      "chapter": {
        "name": "Al-Baqara",
        "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
        "name_meaning": "The Cow",
        "number": 2,
        "url": "https://alquran.cloud/surah/2"
      },
      "juz": 3,
      "number": 262,
      "number_in_chapter": 255,
      "page": 42,
      "prostration": null,
      "reference": "2:255",
      "requires_prostration": false,
      "translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence.",
      "url": "https://alquran.cloud/ayah/2:255"
    }
  ]
}

Get a juz

Get one of the 30 juz, the parts the Qur'an is divided into for reading a day at a time through Ramadan, in Arabic and in the translation you pick. Put it on a schedule with the day of the month as the number and the whole month reads itself. No API key required.

Inputs

JuzjuznumberRequired: Which of the 30 juz, counting from 1. Juz 30 is the short final chapters.From 1 to 30.
Translationtranslationtext: Which translation to return alongside the Arabic. 118 translations in 49 languages, plus commentaries and transliterations. Saheeh International (English) if you leave it alone.Default: en.sahih.
Reciterrecitertext: Optional. Adds a link to an audio recording of each verse. Leave empty if you don't need audio.
Number of verseslimitnumber: Optional. Leave empty for the whole juz, which is between 148 and 564 verses, or set it to read one in shorter sittings.From 1 to 1000.
Skipoffsetnumber: Optional. How many verses to skip before this page. Use the next offset from the previous result to carry on where it stopped.At least 0. Default: 0.

Outputs

countnumber: How many records are in this page.
has_moretrue/false: Whether more remain after this page.
juznumber: Which juz this is, 1 to 30.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
reciterobject: The reciter that was chosen, or null if none was.
total_countnumber: How many there are in total, before paging.
translationobject: The translation these verses came back in.
verseslist: The verses of the juz, in order.

Example output

{
  "count": 1,
  "has_more": true,
  "juz": 3,
  "next_offset": 1,
  "reciter": {
    "direction": null,
    "id": "ar.alafasy",
    "kind": "verse_audio",
    "kind_label": "Recitation, verse by verse",
    "language": "ar",
    "language_name": "Arabic",
    "name": "Alafasy",
    "native_name": "\u0645\u0634\u0627\u0631\u064a \u0627\u0644\u0639\u0641\u0627\u0633\u064a"
  },
  "total_count": 170,
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  },
  "verses": [
    {
      "arabic": "\u0671\u0644\u0644\u064e\u0651\u0647\u064f \u0644\u064e\u0622 \u0625\u0650\u0644\u064e\u0670\u0647\u064e \u0625\u0650\u0644\u064e\u0651\u0627 \u0647\u064f\u0648\u064e \u0671\u0644\u0652\u062d\u064e\u0649\u064f\u0651 \u0671\u0644\u0652\u0642\u064e\u064a\u064f\u0651\u0648\u0645\u064f",
      "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/262.mp3",
      "chapter": {
        "name": "Al-Baqara",
        "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
        "name_meaning": "The Cow",
        "number": 2,
        "url": "https://alquran.cloud/surah/2"
      },
      "juz": 3,
      "number": 262,
      "number_in_chapter": 255,
      "page": 42,
      "prostration": null,
      "reference": "2:255",
      "requires_prostration": false,
      "translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence.",
      "url": "https://alquran.cloud/ayah/2:255"
    }
  ]
}

Get a page

Get one page of the printed Qur'an, the 604-page mushaf everyone reads from, in Arabic and in the translation you pick. A page a day is the reading plan that finishes in two years, and this is the step that fetches today's. No API key required.

Inputs

PagepagenumberRequired: Which page of the standard 604-page mushaf, counting from 1.From 1 to 604.
Translationtranslationtext: Which translation to return alongside the Arabic. 118 translations in 49 languages, plus commentaries and transliterations. Saheeh International (English) if you leave it alone.Default: en.sahih.
Reciterrecitertext: Optional. Adds a link to an audio recording of each verse. Leave empty if you don't need audio.

Outputs

countnumber: How many records are in this page.
has_moretrue/false: Whether more remain after this page.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
pagenumber: Which page this is, 1 to 604.
reciterobject: The reciter that was chosen, or null if none was.
total_countnumber: How many there are in total, before paging.
translationobject: The translation these verses came back in.
urltext: The page on alquran.cloud, ready to link to.
verseslist: The verses printed on that page, in order.

Example output

{
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "page": 42,
  "reciter": {
    "direction": null,
    "id": "ar.alafasy",
    "kind": "verse_audio",
    "kind_label": "Recitation, verse by verse",
    "language": "ar",
    "language_name": "Arabic",
    "name": "Alafasy",
    "native_name": "\u0645\u0634\u0627\u0631\u064a \u0627\u0644\u0639\u0641\u0627\u0633\u064a"
  },
  "total_count": 6,
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  },
  "url": "https://alquran.cloud/mushaf/42",
  "verses": [
    {
      "arabic": "\u0671\u0644\u0644\u064e\u0651\u0647\u064f \u0644\u064e\u0622 \u0625\u0650\u0644\u064e\u0670\u0647\u064e \u0625\u0650\u0644\u064e\u0651\u0627 \u0647\u064f\u0648\u064e \u0671\u0644\u0652\u062d\u064e\u0649\u064f\u0651 \u0671\u0644\u0652\u0642\u064e\u064a\u064f\u0651\u0648\u0645\u064f",
      "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/262.mp3",
      "chapter": {
        "name": "Al-Baqara",
        "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
        "name_meaning": "The Cow",
        "number": 2,
        "url": "https://alquran.cloud/surah/2"
      },
      "juz": 3,
      "number": 262,
      "number_in_chapter": 255,
      "page": 42,
      "prostration": null,
      "reference": "2:255",
      "requires_prostration": false,
      "translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence.",
      "url": "https://alquran.cloud/ayah/2:255"
    }
  ]
}

Get a verse

Get one verse of the Qur'an by chapter and number, in Arabic and in the translation you pick, with a recitation of it if you want one. The step behind quoting a verse in a message, a newsletter or a card. No API key required.

Inputs

ChapterchaptertextRequired: Which of the Qur'an's 114 chapters (surahs).One of: 1 (1. Al-Faatiha (The Opening)), 2 (2. Al-Baqara (The Cow)), 3 (3. Aal-i-Imraan (The Family of Imraan)), 4 (4. An-Nisaa (The Women)), 5 (5. Al-Maaida (The Table)), 6 (6. Al-An'aam (The Cattle)), 7 (7. Al-A'raaf (The Heights)), 8 (8. Al-Anfaal (The Spoils of War)), 9 (9. At-Tawba (The Repentance)), 10 (10. Yunus (Jonas)), and 104 more.
VerseversenumberRequired: Which verse of that chapter, counting from 1. Chapters run from 3 verses to 286, and a number past the end of the chapter you picked says how many it has.From 1 to 286.
Translationtranslationtext: Which translation to return alongside the Arabic. 118 translations in 49 languages, plus commentaries and transliterations. Saheeh International (English) if you leave it alone.Default: en.sahih.
Reciterrecitertext: Optional. Adds a link to an audio recording of each verse. Leave empty if you don't need audio.

Outputs

reciterobject: The reciter that was chosen, or null if none was.
translationobject: The translation these verses came back in.
verseobject: One verse of the Qur'an.

Example output

{
  "reciter": {
    "direction": null,
    "id": "ar.alafasy",
    "kind": "verse_audio",
    "kind_label": "Recitation, verse by verse",
    "language": "ar",
    "language_name": "Arabic",
    "name": "Alafasy",
    "native_name": "\u0645\u0634\u0627\u0631\u064a \u0627\u0644\u0639\u0641\u0627\u0633\u064a"
  },
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  },
  "verse": {
    "arabic": "\u0671\u0644\u0644\u064e\u0651\u0647\u064f \u0644\u064e\u0622 \u0625\u0650\u0644\u064e\u0670\u0647\u064e \u0625\u0650\u0644\u064e\u0651\u0627 \u0647\u064f\u0648\u064e \u0671\u0644\u0652\u062d\u064e\u0649\u064f\u0651 \u0671\u0644\u0652\u0642\u064e\u064a\u064f\u0651\u0648\u0645\u064f",
    "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/262.mp3",
    "chapter": {
      "name": "Al-Baqara",
      "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
      "name_meaning": "The Cow",
      "number": 2,
      "url": "https://alquran.cloud/surah/2"
    },
    "juz": 3,
    "number": 262,
    "number_in_chapter": 255,
    "page": 42,
    "prostration": null,
    "reference": "2:255",
    "requires_prostration": false,
    "translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence.",
    "url": "https://alquran.cloud/ayah/2:255"
  }
}

Get the verse of the day

Get one verse chosen for today, drawn from all 6,236. It is the same verse for the whole day and the same verse for everyone, so a daily post is worth reading and a re-run does not change it. Put it on a schedule and it is a verse a day, with no list to keep. No API key required.

Inputs

Datedatedate: Optional. Leave empty for today. Set it to get the verse for another day: the same one that day would have given, which is how you backfill or look ahead.
Translationtranslationtext: Which translation to return alongside the Arabic. 118 translations in 49 languages, plus commentaries and transliterations. Saheeh International (English) if you leave it alone.Default: en.sahih.
Reciterrecitertext: Optional. Adds a link to an audio recording of each verse. Leave empty if you don't need audio.

Outputs

datetext: The day this verse belongs to, as YYYY-MM-DD. Days run to UTC.
reciterobject: The reciter that was chosen, or null if none was.
translationobject: The translation these verses came back in.
verseobject: One verse of the Qur'an.

Example output

{
  "date": "2026-09-03",
  "reciter": {
    "direction": null,
    "id": "ar.alafasy",
    "kind": "verse_audio",
    "kind_label": "Recitation, verse by verse",
    "language": "ar",
    "language_name": "Arabic",
    "name": "Alafasy",
    "native_name": "\u0645\u0634\u0627\u0631\u064a \u0627\u0644\u0639\u0641\u0627\u0633\u064a"
  },
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  },
  "verse": {
    "arabic": "\u0671\u0644\u0644\u064e\u0651\u0647\u064f \u0644\u064e\u0622 \u0625\u0650\u0644\u064e\u0670\u0647\u064e \u0625\u0650\u0644\u064e\u0651\u0627 \u0647\u064f\u0648\u064e \u0671\u0644\u0652\u062d\u064e\u0649\u064f\u0651 \u0671\u0644\u0652\u0642\u064e\u064a\u064f\u0651\u0648\u0645\u064f",
    "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/262.mp3",
    "chapter": {
      "name": "Al-Baqara",
      "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
      "name_meaning": "The Cow",
      "number": 2,
      "url": "https://alquran.cloud/surah/2"
    },
    "juz": 3,
    "number": 262,
    "number_in_chapter": 255,
    "page": 42,
    "prostration": null,
    "reference": "2:255",
    "requires_prostration": false,
    "translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence.",
    "url": "https://alquran.cloud/ayah/2:255"
  }
}

List chapters

List the Qur'an's 114 chapters in order, each with its name, what the name means, how many verses it holds and where it was revealed. The index to build a table of contents from, to loop a workflow over, or to find a chapter by name when you only remember what it is about. No API key required.

Inputs

Revealed inrevelationtext: Optional. Keep only the chapters revealed in Mecca or only those revealed in Medina.One of: all (Revealed anywhere), meccan (Revealed in Mecca), medinan (Revealed in Medina). Default: all.
Search textsearchtext: Optional. Keep only the chapters whose name or meaning contains this text, ignoring capitals. 'Cow' finds Al-Baqara.

Outputs

chapterslist: The chapters that matched, in order.
countnumber: How many records are in this page.
has_moretrue/false: Whether more remain after this page.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
total_countnumber: How many there are in total, before paging.

Example output

{
  "chapters": [
    {
      "name": "Al-Baqara",
      "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
      "name_meaning": "The Cow",
      "number": 2,
      "revealed_in": "Medinan",
      "url": "https://alquran.cloud/surah/2",
      "verse_count": 286
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "total_count": 114
}

List the verses of prostration

Get all 15 verses at which a prostration is made, each saying whether it is obligatory or recommended, in Arabic and in the translation you pick. The whole set in one step, so a reader or a reminder can know when one is coming. No API key required.

Inputs

Translationtranslationtext: Which translation to return alongside the Arabic. 118 translations in 49 languages, plus commentaries and transliterations. Saheeh International (English) if you leave it alone.Default: en.sahih.
Reciterrecitertext: Optional. Adds a link to an audio recording of each verse. Leave empty if you don't need audio.

Outputs

countnumber: How many records are in this page.
has_moretrue/false: Whether more remain after this page.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
reciterobject: The reciter that was chosen, or null if none was.
total_countnumber: How many there are in total, before paging.
translationobject: The translation these verses came back in.
verseslist: The verses of prostration, in the order they appear.

Example output

{
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "reciter": {
    "direction": null,
    "id": "ar.alafasy",
    "kind": "verse_audio",
    "kind_label": "Recitation, verse by verse",
    "language": "ar",
    "language_name": "Arabic",
    "name": "Alafasy",
    "native_name": "\u0645\u0634\u0627\u0631\u064a \u0627\u0644\u0639\u0641\u0627\u0633\u064a"
  },
  "total_count": 15,
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  },
  "verses": [
    {
      "arabic": "\u0671\u0644\u0644\u064e\u0651\u0647\u064f \u0644\u064e\u0622 \u0625\u0650\u0644\u064e\u0670\u0647\u064e \u0625\u0650\u0644\u064e\u0651\u0627 \u0647\u064f\u0648\u064e \u0671\u0644\u0652\u062d\u064e\u0649\u064f\u0651 \u0671\u0644\u0652\u0642\u064e\u064a\u064f\u0651\u0648\u0645\u064f",
      "audio_url": "https://cdn.islamic.network/quran/audio/128/ar.alafasy/262.mp3",
      "chapter": {
        "name": "Al-Baqara",
        "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
        "name_meaning": "The Cow",
        "number": 2,
        "url": "https://alquran.cloud/surah/2"
      },
      "juz": 3,
      "number": 1160,
      "number_in_chapter": 206,
      "page": 42,
      "prostration": {
        "obligatory": false,
        "recommended": true
      },
      "reference": "7:206",
      "requires_prostration": true,
      "translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence.",
      "url": "https://alquran.cloud/ayah/7:206"
    }
  ]
}

List translations and recitations

See what Al Quran Cloud publishes: 118 translations in 49 languages, six Arabic commentaries, three transliterations and 190 recitations. Filter by language or by what it is. Every record carries the id the Translation and Reciter fields store, so a workflow can choose one and hand it to another step. No API key required.

Inputs

Languagelanguagetext: Optional. Keep only what has been published in one language. Leave empty for all 49.
Showshowtext: Optional. Keep only translations, only recitations, or only one of the other kinds.One of: all (Everything), translation (Translations), tafsir (Commentary (tafsir)), transliteration (Transliterations), quran (Arabic Qur'an text), verse_audio (Recitations, verse by verse), chapter_audio (Recitations, whole chapter). Default: all.
Search textsearchtext: Optional. Keep only the ones whose name or language contains this text, ignoring capitals.
Number of resultslimitnumber: Optional. Leave empty to list every one that matched.From 1 to 1000.
Skipoffsetnumber: Optional. How many verses to skip before this page. Use the next offset from the previous result to carry on where it stopped.At least 0. Default: 0.

Outputs

countnumber: How many records are in this page.
editionslist: What matched, grouped by language and then by name.
has_moretrue/false: Whether more remain after this page.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
total_countnumber: How many there are in total, before paging.

Example output

{
  "count": 1,
  "editions": [
    {
      "direction": "ltr",
      "id": "en.sahih",
      "kind": "translation",
      "kind_label": "Translation",
      "language": "en",
      "language_name": "English",
      "name": "Saheeh International",
      "native_name": "Saheeh International"
    }
  ],
  "has_more": true,
  "next_offset": 1,
  "total_count": 331
}

Search the Qur'an

Find every verse containing a word or phrase, across the whole Qur'an or within one chapter. Search an English translation to look in English, or an Arabic text to search the original. Finding nothing comes back as an empty result rather than an error, so a workflow can branch on it. No API key required.

Inputs

Search fortexttextRequired: The word or phrase to look for. Matched against the text you are searching, ignoring capitals.
Where to searchchaptertext: Search everything, or narrow it to one chapter.One of: all (The whole Qur'an), 1 (1. Al-Faatiha (The Opening)), 2 (2. Al-Baqara (The Cow)), 3 (3. Aal-i-Imraan (The Family of Imraan)), 4 (4. An-Nisaa (The Women)), 5 (5. Al-Maaida (The Table)), 6 (6. Al-An'aam (The Cattle)), 7 (7. Al-A'raaf (The Heights)), 8 (8. Al-Anfaal (The Spoils of War)), 9 (9. At-Tawba (The Repentance)), and 105 more. Default: all.
Search intranslationtext: Which text to search. Pick a translation to search in that language, or one of the Arabic Qur'an texts to search the original. Saheeh International (English) if you leave it alone.Default: en.sahih.
Number of resultslimitnumber: Optional. How many matching verses to return; 25 by default. The result says how many matched in total.From 1 to 1000. Default: 25.
Skipoffsetnumber: Optional. How many verses to skip before this page. Use the next offset from the previous result to carry on where it stopped.At least 0. Default: 0.

Outputs

countnumber: How many records are in this page.
has_moretrue/false: Whether more remain after this page.
matcheslist: The verses that matched, in the order they appear in the Qur'an.
next_offsetnumber: The offset that fetches the next page. Null on the last one.
searchedtext: What was searched for.
total_countnumber: How many there are in total, before paging.
translationobject: The translation these verses came back in.

Example output

{
  "count": 1,
  "has_more": true,
  "matches": [
    {
      "chapter": {
        "name": "Al-Baqara",
        "name_arabic": "\u0633\u064f\u0648\u0631\u064e\u0629\u064f \u0627\u0644\u0628\u064e\u0642\u064e\u0631\u064e\u0629\u0650",
        "name_meaning": "The Cow",
        "number": 2,
        "url": "https://alquran.cloud/surah/2"
      },
      "number": 264,
      "number_in_chapter": 257,
      "reference": "2:257",
      "text": "Allah is the ally of those who believe. He brings them out from darknesses into the light.",
      "url": "https://alquran.cloud/ayah/2:257"
    }
  ],
  "next_offset": 1,
  "searched": "the light",
  "total_count": 12,
  "translation": {
    "direction": "ltr",
    "id": "en.sahih",
    "kind": "translation",
    "kind_label": "Translation",
    "language": "en",
    "language_name": "English",
    "name": "Saheeh International",
    "native_name": "Saheeh International"
  }
}

ActionsCopy Anchor Link

Get a chapterCopy Anchor Link

Inputs

Outputs

Get a juzCopy Anchor Link

Inputs

Outputs

Get a pageCopy Anchor Link

Inputs

Outputs

Get a verseCopy Anchor Link

Inputs

Outputs

Get the verse of the dayCopy Anchor Link

Inputs

Outputs

List chaptersCopy Anchor Link

Inputs

Outputs

List the verses of prostrationCopy Anchor Link

Inputs

Outputs

List translations and recitationsCopy Anchor Link

Inputs

Outputs

Search the Qur'anCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get a chapter

Get a juz

Get a page

Get a verse

Get the verse of the day

List chapters

List the verses of prostration

List translations and recitations

Search the Qur'an