# Quran.com API: Search Quran verses

> Finds Quran.com verses matching a word or topic, with Arabic text and a translation in the selected language, in Quran.com search order.

Unofficial. Not affiliated with or endorsed by Quran.com.

- Page: https://fous.com/methods/quran.com/search-quran
- Method: `quran.com/search_quran`, version 1
- Website: quran.com
- Returns: verse reference, surah name, Arabic text, translation, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"caridad"` | Words or a topic to find in the Quran, such as patience or charity. |
| `language` | string | no | `"Spanish"` | Language of translations to search and return, such as English, Spanish, or French. Default "English". |
| `max_results` | integer | no | `50` | Maximum number of verses to return, from 1 to 50, such as 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "query": "caridad",
  "language": "Spanish",
  "max_results": 50
}
```

Its output:

```json
{
  "verses": [
    {
      "link": "https://quran.com/63/10",
      "reference": "63:10",
      "surah_name": "Al-Munafiqun",
      "arabic_text": "وَأَنفِقُوا۟ مِن مَّا رَزَقْنَـٰكُم مِّن قَبْلِ أَن يَأْتِىَ أَحَدَكُمُ ٱلْمَوْتُ فَيَقُولَ رَبِّ لَوْلَآ أَخَّرْتَنِىٓ إِلَىٰٓ أَجَلٍ قَرِيبٍ فَأَصَّدَّقَ وَأَكُن مِّنَ ٱلصَّـٰلِحِينَ",
      "translation_text": "Y dad en caridad parte de lo que os ha proveído antes de que la muerte le sobrevenga a alguno de vosotros y este diga: «¡Señor!, ¿por qué no me concedes un poco más de tiempo para que pueda dar caridad y estar entre los rectos y virtuosos?»."
    },
    {
      "link": "https://quran.com/3/92",
      "reference": "3:92",
      "surah_name": "Ali 'Imran",
      "arabic_text": "لَن تَنَالُوا۟ ٱلْبِرَّ حَتَّىٰ تُنفِقُوا۟ مِمَّا تُحِبُّونَ ۚ وَمَا تُنفِقُوا۟ مِن شَىْءٍ فَإِنَّ ٱللَّهَ بِهِۦ عَلِيمٌ",
      "translation_text": "[Los creyentes] no alcanzarán la piedad auténtica hasta que den [en caridad ] lo que más aman. Todo lo que deis en caridad Dios lo sabe."
    },
    {
      "link": "https://quran.com/57/7",
      "reference": "57:7",
      "surah_name": "Al-Hadid",
      "arabic_text": "ءَامِنُوا۟ بِٱللَّهِ وَرَسُولِهِۦ وَأَنفِقُوا۟ مِمَّا جَعَلَكُم مُّسْتَخْلَفِينَ فِيهِ ۖ فَٱلَّذِينَ ءَامَنُوا۟ مِنكُمْ وَأَنفَقُوا۟ لَهُمْ أَجْرٌ كَبِيرٌ",
      "translation_text": "Creed en Dios y en Su Mensajero. Dad caridad de los bienes de los que Él los ha hecho responsables. Quienes hayan creído y hecho caridades recibirán una gran recompensa."
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"quran.com/search_quran","input":{"query":"caridad","language":"Spanish","max_results":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find verses in the Quran about patience, show me the Arabic and English translation, up to 10 results
- I need Quran verses mentioning charity with Spanish translations, max 15 results
- Search quran.com for verses about mercy in French
- What Quran verses talk about gratitude? Give me the surah names and links, 25 results
- Look up Quran passages containing the word knowledge with translations in English, limit 5

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "patience"
      ],
      "minLength": 1,
      "description": "Words or a topic to find in the Quran, such as patience or charity."
    },
    "language": {
      "type": "string",
      "default": "English",
      "examples": [
        "Spanish"
      ],
      "description": "Language of translations to search and return, such as English, Spanish, or French."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum number of verses to return, from 1 to 50, such as 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "verses"
  ],
  "properties": {
    "verses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "reference",
          "surah_name",
          "translation_text",
          "arabic_text",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string",
            "description": "Link to the verse on Quran.com."
          },
          "reference": {
            "type": "string",
            "description": "Surah and verse number, such as 2:153."
          },
          "surah_name": {
            "type": "string",
            "description": "Name of the surah."
          },
          "arabic_text": {
            "type": "string",
            "description": "Arabic verse text."
          },
          "translation_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Translation text in the selected language, or null when unavailable."
          }
        }
      },
      "description": "Verses in Quran.com search order."
    }
  }
}
```

## See more

- [Bible Gateway API: Search the Bible](https://fous.com/methods/biblegateway.com/search-bible.md): Finds Bible verses on Bible Gateway that contain the search words or relate to a topic. Returns the verse text and links in Bible order.
- [Poetry Foundation API: Search poems](https://fous.com/methods/poetryfoundation.org/search-poems.md): Finds poems matching a topic or occasion, or poems by a named poet, in Poetry Foundation search order. Older magazine poems without public text have no first two lines; untagged poems have no themes or occasions.
- [Britannica API: Search articles](https://fous.com/methods/britannica.com/search-articles.md): Searches Britannica for encyclopedia articles and returns their titles, short descriptions, article links and images when shown. Excludes other search formats such as videos, questions and stories.
- [Al Jazeera API: Search news](https://fous.com/methods/aljazeera.com/search-news.md): Searches Al Jazeera articles by keyword, newest first or by relevance, with optional publication dates, and returns each article's headline, summary, time, authors and section. Searches up to the 100 matches Al Jazeera's search offers.
- [Bible Gateway API: Get Bible passage](https://fous.com/methods/biblegateway.com/get-passage.md): Reads up to one chapter of a Bible passage in a chosen Bible Gateway translation. Licensed translations may show only part of the requested passage.
- [Wikimedia Commons API: Search free images](https://fous.com/methods/commons.wikimedia.org/search-free-images.md): Finds free-to-use Wikimedia Commons images for a topic in Commons relevance order. Each image comes with its links, creator and licence details.
- [Google API: Get search suggestions](https://fous.com/methods/google.com/get-search-suggestions.md): Gets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language.
- [Wikipedia API: Search articles](https://fous.com/methods/wikipedia.org/search-articles.md): Searches a Wikipedia language edition by keywords and returns matching articles in relevance order, with descriptions, snippets, word counts, last edit dates and links.