Media CDN · شبكة التوصيل

Al Quran Content Delivery Network (CDN)

Al Quran Cloud provides an open CDN to serve ayah and surah audio files and Quran ayah images to allow you integrate media into your app. The documentation below explains how to access the media. Please note that the CDN is available over both http and https. The CDN is available at https://cdn.islamic.network globally. For Russian users, we operate infrastructure in Russia at https://cdn.alislam.ru.

I · Audio by Ayah

Audio files by Ayah

Audio files by ayah are also referenced in the API responses for audio editions via https://api.alquran.cloud/v1/edition/format/audio. To use a particular edition for a surah to stream by ayah: https://api.alquran.cloud/v1/surah/1/ar.alafasy. Ayah audio files can be accessed on the CDN directly via the following URL:

Pattern

https://cdn.islamic.network/quran/audio/{bitrate}/{edition}/{number}.mp3

{edition} — An audio edition as returned by the API (example: ar.alafasy). A list of these editions is available at https://api.alquran.cloud/v1/edition/format/audio.
{number} — An ayah number. The Quran contains 6236 ayahs, so this must be a number between 1 and 6236.
{bitrate} — Quality of audio served. Acceptable values are 192, 128, 64, 48, 40 and 32. You can see which edition is available in what sizes at info.txt or info.json.

Examples

II · Audio by Surah

Audio files by Surah

Surah audio files are available to stream via the CDN. Please note that surah audio files are not integrated with the API as the API deals with ayah level detail. For programmatic integration, you can use the JSON list of audio editions by surah at https://cdn.islamic.network/quran/info/by-surah/info.json. Surah audio files can be accessed on the CDN directly via the following URL:

Pattern

https://cdn.islamic.network/quran/audio-surah/{bitrate}/{edition}/{number}.mp3

{edition} — An audio edition available on info.json (example: ar.alafasy).
{number} — A surah number. The Quran contains 114 surahs, so this must be a number between 1 and 114.
{bitrate} — Quality of audio served. Different editions are available at different bitrates. You can see which edition is available at what bitrate on info.json.

Examples

III · Ayah Images

Get Quran Ayah Images

Image files can be accessed via the CDN in normal and high resolution using the following URLs:

Pattern

https://cdn.islamic.network/quran/images/{surah}_{ayah}.png

https://cdn.islamic.network/quran/images/high-resolution/{surah}_{ayah}.png

{surah} — A surah number (from 1 to 114).
{ayah} — An ayah number relative to the surah.

Examples

Available bitrates

Substitute any of the values below for {bitrate}. Acceptable values are 192, 128, 64, 48, 40 and 32 — higher bitrates are larger but kinder on the ear; lower bitrates load faster on cellular.

kbps	Notes
`32`	Smallest files · best on cellular
`40`	Telephony quality
`48`	Compact speech
`64`	Spoken-word standard
`128`	Recommended general use
`192`	Higher fidelity

Reciter identifiers (sample)

Substitute any of the identifiers below for {edition}. The authoritative live list lives at /v1/edition/format/audio.

Identifier	Reciter	Style	Default kbps
`ar.alafasy`	Mishary Rashid Alafasyمشاري راشد العفاسي	Murattal	128
`ar.husary`	Mahmoud Khalil Al-Husaryمحمود خليل الحصري	Murattal	128
`ar.minshawi`	Mohamed Siddiq al-Minshawiمحمد صديق المنشاوي	Murattal	128
`ar.minshawimujawwad`	Al-Minshawiمحمد صديق المنشاوي	Mujawwad	64
`ar.sudais`	Abdul Rahman Al-Sudaisعبدالرحمن السديس	Murattal	192
`ar.shuraim`	Saud Al-Shuraimسعود الشريم	Murattal	128
`ar.abdulbasit`	Abdul Basit Abdul Samadعبد الباسط عبد الصمد	Murattal	192
`ar.abdulbasitmujawwad`	Abdul Basitعبد الباسط عبد الصمد	Mujawwad	192
`ar.ajamy`	Ahmed ibn Ali al-Ajamyأحمد بن علي العجمي	Murattal	128
`ar.muhammadayoub`	Muhammad Ayyoubمحمد أيوب	Murattal	128
`ar.hudhaify`	Ali Al-Hudhaifyعلي بن عبدالرحمن الحذيفي	Murattal	128
`ar.muhammadjibreel`	Muhammad Jibreelمحمد جبريل	Murattal	128
`ar.parhizgar`	Mahmoud Khalil Al-Husaryمحمود خليل الحصري	Muallim	64

Served from cdn.islamic.network (and cdn.alisam.ru.ru in Russia) · over both http and https