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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Query, required
query Words or a topic to find in the Quran, such as patience or charity.
caridad
- Language optional
language Language of translations to search and return, such as English, Spanish, or French.
Spanish
Default
English.- Max Results optional
max_results Maximum number of verses to return, from 1 to 50, such as 20.
50
Whole number from 1 to 50. Default
20.
Input as JSON
{ "query": "caridad", "language": "Spanish", "max_results": 50}Output
{ "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." } ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "quran.com/search_quran" , "input": { "query": "caridad", "language": "Spanish", "max_results": 50 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "quran.com/search_quran" , "input": { "query": "caridad", "language": "Spanish", "max_results": 50 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run quran.com/search_quran# with {"query":"caridad","language":"Spanish","max_results":50}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
quran.com/search_quran- Returns
- verse reference, surah name, Arabic text, translation, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method quran.com/search_quran with the inputs above.
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
See more
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.
biblegateway.com/search_bibleFinds 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.
poetryfoundation.org/search_poemsSearches 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.
britannica.com/search_articlesSearches 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.
aljazeera.com/search_newsReads up to one chapter of a Bible passage in a chosen Bible Gateway translation. Licensed translations may show only part of the requested passage.
biblegateway.com/get_passageFinds free-to-use Wikimedia Commons images for a topic in Commons relevance order. Each image comes with its links, creator and licence details.
commons.wikimedia.org/search_free_imagesGets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language.
google.com/get_search_suggestionsSearches a Wikipedia language edition by keywords and returns matching articles in relevance order, with descriptions, snippets, word counts, last edit dates and links.
wikipedia.org/search_articles