{"info":{"_postman_id":"ca1839e6-3892-4deb-8137-e5bada51650e","name":"Al-Quran Cloud API","description":"

Al-Quran Cloud API Documentation

This document provides a comprehensive guide to the Al-Quran Cloud API (v1) endpoints.

Base URL: https://api.alquran.cloud/v1/

📖 Quran Text & Verses

These endpoints are for fetching specific parts of the Quran.

1. Get a Specific Ayah

Fetches a single Ayah by its reference (surah_number:ayah_number).

Method: GET
\n
Endpoint: /ayah/{reference}
\n
Example URL: https://api.alquran.cloud/v1/ayah/2:255
\n
cURL: curl --location 'https://api.alquran.cloud/v1/ayah/2:255'
\n

2. Get an Ayah with Translation(s)

Fetches an Ayah along with one or more translations. You can append a single edition or a comma-separated list of editions to the URL.

Method: GET
\n
Endpoint: /ayah/{reference}/{edition}
\n
Example URL (Single): https://api.alquran.cloud/v1/ayah/2:255/en.sahih
\n
cURL (Single): curl --location 'https://api.alquran.cloud/v1/ayah/2:255/en.sahih'
\n
Example URL (Multiple): https://api.alquran.cloud/v1/ayah/2:255/en.sahih,ar.alafasy
\n
cURL (Multiple): curl --location 'https://api.alquran.cloud/v1/ayah/2:255/en.sahih,ar.alafasy'
\n

3. Get a Specific Surah

Fetches an entire Surah.

Method: GET
\n
Endpoint: /surah/{surah_number}
\n
Example URL: https://api.alquran.cloud/v1/surah/18
\n
cURL: curl --location 'https://api.alquran.cloud/v1/surah/18'
\n

4. Get a Surah with Translation

Fetches a Surah along with a translation.

Method: GET
\n
Endpoint: /surah/{surah_number}/{edition}
\n
Example URL: https://api.alquran.cloud/v1/surah/18/en.pickthall
\n
cURL: curl --location 'https://api.alquran.cloud/v1/surah/18/en.pickthall'
\n

5. Get a Specific Juz

Fetches all Ayahs in a specific Juz.

Method: GET
\n
Endpoint: /juz/{juz_number}/{edition}
\n
Example URL: https://api.alquran.cloud/v1/juz/30/quran-uthmani
\n
cURL: curl --location 'https://api.alquran.cloud/v1/juz/30/quran-uthmani'
\n

🔍 Search

1. Search for a Keyword

Searches for a keyword within a specific Surah or across all Surahs. The edition must be a translation.

Method: GET
\n
Endpoint: /search/{keyword}/{surah_or_all}/{edition}
\n
Example URL (Specific Surah): https://api.alquran.cloud/v1/search/Joseph/12/en.sahih
\n
cURL (Specific Surah): curl --location 'https://api.alquran.cloud/v1/search/Joseph/12/en.sahih'
\n
Example URL (All Surahs): https://api.alquran.cloud/v1/search/mercy/all/en.sahih
\n
cURL (All Surahs): curl --location 'https://api.alquran.cloud/v1/search/mercy/all/en.sahih'
\n

⚙️ Metadata & Editions

These endpoints provide information about the available Quran editions, translations, and structure.

1. Get All Editions

Fetches a list of all available Quran editions (text, translation, transliteration, tafsir).

Method: GET
\n
Endpoint: /edition
\n
Example URL: https://api.alquran.cloud/v1/edition
\n
cURL: curl --location 'https://api.alquran.cloud/v1/edition'
\n

2. Get Editions by Type

Fetches editions filtered by a specific type. Possible types are: translation, tafsir, transliteration, and quran.

Method: GET
\n
Endpoint: /edition/type/{type}
\n
Example URL: https://api.alquran.cloud/v1/edition/type/translation
\n
cURL: curl --location 'https://api.alquran.cloud/v1/edition/type/translation'
\n

3. Get Editions by Language

Fetches editions filtered by a specific language ISO code.

Method: GET
\n
Endpoint: /edition/language/{language_iso_code}
\n
Example URL: https://api.alquran.cloud/v1/edition/language/fr
\n
cURL: curl --location 'https://api.alquran.cloud/v1/edition/language/fr'
\n

4. Get General Metadata

Fetches metadata about all Surahs, Juz, and Hizbs in the Quran. This is useful for building navigation.

Method: GET
\n
Endpoint: /meta
\n
Example URL: https://api.alquran.cloud/v1/meta
\n
cURL: curl --location 'https://api.alquran.cloud/v1/meta'
\n

☁️ CDN Media

These endpoints link directly to media files on the Content Delivery Network (CDN). They are useful for streaming audio or displaying images.

1. Get an Ayah Image

Fetches a .png image of a specific Ayah.

Method: GET
\n
Endpoint: https://cdn.alquran.cloud/media/image/{surahNumber}/{ayahNumber}
\n
Example URL: https://cdn.alquran.cloud/media/image/2/255
\n
cURL: curl --location 'https://cdn.alquran.cloud/media/image/2/255'
\n

2. Get an Ayah Audio

Fetches an .mp3 audio file of a specific Ayah by a chosen reciter.

Method: GET
\n
Endpoint: https://cdn.alquran.cloud/media/audio/ayah/{reciter_edition}/{ayah_reference}
\n
Example URL: https://cdn.alquran.cloud/media/audio/ayah/ar.alafasy/255
\n
cURL: curl --location 'https://cdn.alquran.cloud/media/audio/ayah/ar.alafasy/255'
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Al-Quran Cloud API Documentation","slug":"al-quran-cloud-api-documentation"}],"owner":"9793048","collectionId":"ca1839e6-3892-4deb-8137-e5bada51650e","publishedId":"2sB3BEoqSE","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-08-11T20:27:38.000Z"},"item":[{"name":"Quran Text & Verses","item":[{"name":"Get a Specific Ayah","id":"55b47f0a-ceb6-499b-95d7-a0c71325086a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/ayah/2:255","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/ayah/2:255'

\n","urlObject":{"protocol":"http","path":["v1","ayah","2:255"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"55b47f0a-ceb6-499b-95d7-a0c71325086a"},{"name":"Get an Ayah with Translation","id":"2c33a8d8-8dbd-4193-bcd5-8a093f2ef105","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/ayah/2:255/en.sahih","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/ayah/2:255/en.sahih'

\n","urlObject":{"protocol":"http","path":["v1","ayah","2:255","en.sahih"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"2c33a8d8-8dbd-4193-bcd5-8a093f2ef105"},{"name":"Get a Specific Surah","id":"1dae73a5-b384-4ce6-9ea0-58060b411945","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/surah/18","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/surah/18'

\n","urlObject":{"protocol":"http","path":["v1","surah","18"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"1dae73a5-b384-4ce6-9ea0-58060b411945"},{"name":"Get a Surah with Translation","id":"2873e8f5-c5e4-4b20-b931-b9cc2c60e29d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/surah/18/en.pickthall","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/surah/18/en.pickthall'

\n","urlObject":{"protocol":"http","path":["v1","surah","18","en.pickthall"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"2873e8f5-c5e4-4b20-b931-b9cc2c60e29d"},{"name":"Get a Specific Juz","id":"ec154ac3-33a7-4174-8ead-0c28ae7254d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/juz/30/quran-uthmani","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/juz/30/quran-uthmani'

\n","urlObject":{"protocol":"http","path":["v1","juz","30","quran-uthmani"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"ec154ac3-33a7-4174-8ead-0c28ae7254d1"}],"id":"5639d8e9-9d5e-42b2-8a20-2780545213e4","_postman_id":"5639d8e9-9d5e-42b2-8a20-2780545213e4","description":""},{"name":"Search","item":[{"name":"Search for a Keyword","id":"9d550085-0dd0-449c-bd87-452a26734259","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/search/Joseph/12/en.sahih","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/search/Joseph/12/en.sahih'

\n","urlObject":{"protocol":"http","path":["v1","search","Joseph","12","en.sahih"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"9d550085-0dd0-449c-bd87-452a26734259"}],"id":"1f2166a7-4ec7-4d6c-b8f0-b92f3ed70748","_postman_id":"1f2166a7-4ec7-4d6c-b8f0-b92f3ed70748","description":""},{"name":"Metadata & Editions","item":[{"name":"Get All Editions","id":"4ab72cd6-0b7a-424b-90d0-86f7616fcaf9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/edition","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/edition'

\n","urlObject":{"protocol":"http","path":["v1","edition"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"4ab72cd6-0b7a-424b-90d0-86f7616fcaf9"},{"name":"Get Editions by Type","id":"2cbcd163-12b4-4eaf-94b2-bb945407ff4d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/edition/type/translation","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/edition/type/translation'

\n","urlObject":{"protocol":"http","path":["v1","edition","type","translation"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"2cbcd163-12b4-4eaf-94b2-bb945407ff4d"},{"name":"Get Editions by Language","id":"4be979ec-c634-4367-b7a2-b1197b0997a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/edition/language/fr","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/edition/language/fr'

\n","urlObject":{"protocol":"http","path":["v1","edition","language","fr"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"4be979ec-c634-4367-b7a2-b1197b0997a6"},{"name":"Get General Metadata","id":"9b0a487b-701e-41a2-bf9e-e127012953f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://api.alquran.cloud/v1/meta","description":"

Generated from cURL: curl --location 'http://api.alquran.cloud/v1/meta'

\n","urlObject":{"protocol":"http","path":["v1","meta"],"host":["api","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"9b0a487b-701e-41a2-bf9e-e127012953f7"}],"id":"42ac537a-de06-4e2d-86b5-33627be718ef","_postman_id":"42ac537a-de06-4e2d-86b5-33627be718ef","description":""},{"name":"Audio CDN","item":[{"name":"Audio of a Specific Ayah","id":"6d6956d6-53c6-4de2-b6e1-f942bf6847e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://cdn.alquran.cloud/media/audio/ayah/ar.alafasy/1","description":"

Generated from cURL: curl --location 'https://cdn.alquran.cloud/media/audio/ayah/ar.alafasy/1'

\n","urlObject":{"protocol":"https","path":["media","audio","ayah","ar.alafasy","1"],"host":["cdn","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"6d6956d6-53c6-4de2-b6e1-f942bf6847e1"},{"name":"Audio of an Entire Surah","id":"07f492a8-e5c6-4b6c-9cb6-91183bd5037d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://cdn.alquran.cloud/media/audio/surah/ar.alafasy/18","description":"

Generated from cURL: curl --location 'https://cdn.alquran.cloud/media/audio/surah/ar.alafasy/18'

\n","urlObject":{"protocol":"https","path":["media","audio","surah","ar.alafasy","18"],"host":["cdn","alquran","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"07f492a8-e5c6-4b6c-9cb6-91183bd5037d"}],"id":"04601d19-d75f-429d-9678-f069b1aed119","_postman_id":"04601d19-d75f-429d-9678-f069b1aed119","description":""},{"name":"Image CDN","item":[{"name":"Image of a Specific Ayah","id":"03b5cbac-f510-4522-97e2-aafffaecdce6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://cdn.alquran.cloud/media/image/:surahNumber/:ayahNumber","description":"

Generated from cURL: curl --location 'https://cdn.alquran.cloud/media/image/255'

\n","urlObject":{"protocol":"https","path":["media","image",":surahNumber",":ayahNumber"],"host":["cdn","alquran","cloud"],"query":[],"variable":[{"type":"any","value":"2","key":"surahNumber"},{"type":"any","value":"255","key":"ayahNumber"}]}},"response":[],"_postman_id":"03b5cbac-f510-4522-97e2-aafffaecdce6"}],"id":"fba8f291-1537-4ce9-b287-fe6948f70695","_postman_id":"fba8f291-1537-4ce9-b287-fe6948f70695","description":""}],"event":[{"listen":"prerequest","script":{"id":"927a8ee2-05ed-4b08-ab4c-fe03e12d6c03","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"c78b9d79-bcc8-4888-9be9-cedb846f5aeb","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"BASE_URL","value":"http://api.alquran.cloud/v1/","type":"string"}]}