Quran Cloud
Books
A RESTful Quran API to retrieve an Ayah, Surah, Juz or the entire Holy Quran
RESTful Quran API — Ayah, Surah, Juz, or the entire Holy Quran.
Auth
No Auth
HTTPS
Yes
CORS
Yes
API URL
Common Use Cases
- •Build book discovery and recommendation engines
- •Create reading list and library management apps
- •Integrate literary metadata into educational platforms
Integration Guide
Review the API Documentation
Visit the official Quran Cloud documentation to understand available endpoints, request formats, and response structures. Familiarize yourself with the API's rate limits and usage policies before integration.
No Authentication Required
Good news — Quran Cloud does not require any authentication. You can start making API requests directly without registering for an API key or setting up OAuth credentials.
Use HTTPS for Secure Requests
Quran Cloud supports HTTPS, ensuring encrypted communication. Always use HTTPS endpoints in production to protect data in transit and comply with modern web security standards.
CORS Enabled — Direct Browser Access
Quran Cloud has CORS enabled, meaning you can make requests directly from the browser. This is ideal for frontend-only applications built with React, Vue, or vanilla JavaScript.
Implement and Test
Write your API integration code, start with a simple test request to verify connectivity. Implement proper error handling for network failures, rate limits, and invalid responses. Monitor your API usage to stay within any limits.
Code Examples
JavaScript / Fetch API:
// JavaScript example
fetch("https://alquran.cloud/api")
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.json();
})
.then(data => {
console.log("API response:", data);
})
.catch(error => {
console.error("Error fetching from Quran Cloud:", error);
});Python / Requests:
# Python example
import requests
response = requests.get("https://alquran.cloud/api")
if response.status_code == 200:
data = response.json()
print("API response:", data)
else:
print(f"Error: {response.status_code}")Frequently Asked Questions
Is Quran Cloud free to use?
Do I need an API key for Quran Cloud?
Can I use Quran Cloud in a browser-based application?
What category does Quran Cloud belong to?
Is Quran Cloud secure?
Editor's Notes & Deep Dive
Key Features
- →GET /surah returns metadata for all 114 surahs
- →GET /surah/{number} returns the full surah with Arabic text
- →GET /ayah/{reference}/editions/quran-uthmani,en.asad supports multi-edition parallel fetch
- →50+ translations and 5+ audio recitations available
Rate Limits & Quotas
No published hard limit; hosted on AWS, generally responsive. Avoid bursts of >10 req/sec.
Known Issues & Pitfalls
- !Audio file URLs are large MP3s; stream them rather than buffering
- !Some translation editions are incomplete — always check the 'number_of_ayahs' field
How It Compares
More comprehensive than quran-api-books (fawazahmed0) which focuses on translation breadth. Use alquran.cloud for Arabic + audio, fawazahmed0 for 90+ language translations.
Sample Response
{
"code": 200,
"data": {
"number": 1,
"name": "الفاتحة",
"englishName": "Al-Faatiha",
"ayahs": [
{ "number": 1, "text": "بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ" }
]
}
}Pro Tips
- ✓Use the editions parameter to fetch Arabic + translation in a single call