Quran API

quran image quran image

QuranAPI is a featured, free, fast and easy to use API. It comprehensively provides a long list of available Receiters (+200), the full Holly Quran(114 surahs) are available with the voice of almost all the Receiters. The surahs are provided in small compressed MP3 files with a high quality audio.

Telegram Bot Check Docs

Features

fast icon

Our service is rediculously fast, Try it out and see for yourself.

free icon

Our service is completely free of charge, not a single penny.

secure icon

Our service is widely accessible without cors or authentication.

easy icon

Our service is featured yet straight forward and so easy to use.

interactive icon

Our service is nicely documented with highly interactive docs.

How It Works?

End-Points:

  • Get Languages (/langs):

    • Method: GET
    • Parameters: None
    • Usage: Use the provided codes to fetch data in the desired supported language.

  • Get Surahs (/surahs):

    • Method: GET
    • Parameters: str: lang_code
    • Usage: Use the provided codes to fetch surahs

  • Get Readers (/readers):

    • Method: GET
    • Parameters: str: lang_code
    • Usage: Use the provided codes to fetch readers's surahs

  • Get Reader's Surahs (/reader_surahs):

    • Method: GET
    • Parameters: [ str:lang_code, int:reader_id ]
    • Usage: Use the provided codes to fetch the available surahs for each reader.

  • Get Surah Link (/get_surah_link):

    • Method: GET
    • Parameters: [str:lang_code, int:reader_code, int:surah_code]
    • Usage: Use a combination of surah&reader codes to fetch the link.

Requests Samples:

choose programming language
selected language
import request

# Get Langs
langs = requests.get('https://api.quranapi.org/langs').json()

# Get Surahs
surahs = requests.get('https://api.quranapi.org/surahs?lang={code}').json()

# Get Readers
readers = requests.get('https://api.quranapi.org/readers?lang={code}').json()

# Get Reader Surahs
reader_surahs = requests.get(f'https://api.quranapi.org/reader_surahs/lang={code}&reader_id={id}').json()

# Get Surah Link
link = requests.get(f'https://api.quranapi.org/get_surah_link/lang={code}&reader_id={id}&surah_id={id}').json()
require 'net/http'

#Get Langs
url = URI('https://api.quranapi.org/langs')

langs = Net::HTTP.get_response(url)

# Get Surahs
url = URI('https://api.quranapi.org/surahs?lang={code}')

surahs = Net::HTTP.get_response(url)

# Get Readers
url = URI('https://api.quranapi.org/readers?lang={code}')

readers = Net::HTTP.get_response(url)

# Get Reader Surahs
url = URI('https://api.quranapi.org/reader_surahs/lang={code}&reader_id={id}')

reader surahs = Net::HTTP.get_response(url)

# Get Surah Link
url = URI('https://api.quranapi.org/get_surah_link/lang={code}&reader_id={id}&surah_id={id}')

link = Net::HTTP.get_response(url)
//Get Langs
$url = "https://api.quranapi.org/langs";
$langs = file_get_contents($url);

//Get Surahs
$url = "https://api.quranapi.org/surahs?lang={code}";
$surahs = file_get_contents($url);

//Get Readers
$url = "https://api.quranapi.org/readers?lang={code}";
$readers = file_get_contents($url);

//Get Reader Surahs
$url = "https://api.quranapi.org/reader_surahs/lang={code}/reader_id{id}";
$reader surahs = file_get_contents($url);

//Get Surah Link
$url = "https://api.quranapi.org/get_surah_link/lang={code}&reader_id={id}&surah_id={id}";

$link = file_get_contents($url);
# Get Langs
curl https://api.quranapi.org/langs

# Get Surahs
curl https://api.quranapi.org/surahs?lang={code}

# Get Readers
curl https://api.quranapi.org/readers?lang={code}

#Get Reader Surahs
curl https://api.quranapi.org/reader_surahs/lang={code}&reader_id={id}

#Get Surah Link
curl https://api.quranapi.org/get_surah_link/lang={code}&reader_id={id}&surah_id={id}
const axios = require('axios')

// Get Langs
const langs = axios.get('https://api.quranapi.org/langs').then(r => console.log(r.data))

// Get Surahs
const surahs = axios.get('https://api.quranapi.org/surahs?lang={code}').then(r => console.log(r.data))

// Get Readers
const readers = axios.get('https://api.quranapi.org/readers?lang={code}').then(r => console.log(r.data))

// Get Reader Surahs
const reader_surahs = axios.get('https://api.quranapi.org/reader_surahs/lang={code}&reader_id={id}')
.then(r => console.log(r.data))

// Get Surah Link
const link = axios.get('https://api.quranapi.org/get_surah_link/lang={code}&reader_ide={id}&surah_id={id}')
.then(r => console.log(r.data))

Responses Samlpes:

[ {
"id": 1,
"name": "Al-Fatihah ",
"makkiah": 1
},
{
"id": 2,
"name": "Al-Baqarah ",
"makkiah": 0
}
,....]
[
{
"id": 123,
"name": "Hussain Alshaik",
"surahs": "13,14,22,32,38,44,45,49,50,78,79,80,81,82,85"
},
{
"id": 128,
"name": "Wasel Almethen",
"surahs": "8,9,36,38,42,45,50,59,60"
},
...]
{
[1, 2, 3, 8, 12, 13, 25, 33, 41, 58, 66, 81, 103, 114 ]
}
{
"link":"https://server12.mp3quran.net/download/maher/001.mp3"
}
{
"Arabic": "ar",
"English": "eng",
"French": "fr",
"Russian": "ru",
"German": "de",
"Spanish": "es",
"Turkish": "tr",
"Chineese": "cn",
"Farsi": "fa",
"Portuese": "pt",
"sweedish": "sw"
}

About

developper photo
Ismail Saadaoui Full Stack Web Dev

Hey There!
My name is Ismail Saadaoui, I'm a passionate junior full stack web developper, I make Beautiful and Modern websites using Tailwind.css, Interactive and Smooth using React.js, Secure, Powerfull and Scalable using Django.py .
Wait no more to let me bring your ideas to life !

programming art image
designer photo
DJUX UI/UX Designer

Hey There!
My name is Djoudi Med Amine, I'm a passionate junior Ui/UX Designer, I make Intuitive Mindblowing designs using Figma And AdobeXD, I'm also concerned when it comes to all other design types such as logos and cards.
Wait no more to let me bring your ideas into prescriptive !

web design art image