Overview
Quran Cloud offers an API designed for developers seeking to integrate Quranic content into their digital products. The service provides access to the complete text of the Quran, alongside various translations and audio recitations. This enables developers to build a range of applications, from mobile Islamic apps and educational websites to research platforms requiring structured Quranic data. The API is built to deliver content programmatically, supporting diverse use cases where comprehensive and accurate Quranic information is essential.
The platform is suitable for developers who need to display specific verses, chapters (Surahs), or entire translations within their applications. For instance, a mobile app developer might use the Quran API to fetch the text of a particular Ayah (verse) and its translation in English, while a web developer could integrate the Audio API to play recitations of specific Surahs on a website. Academic researchers could utilize the API to programmatically analyze textual patterns or cross-reference translations for linguistic studies. The API architecture focuses on providing structured data, which can be consumed by various programming languages and frameworks, offering flexibility in implementation. Authentication is managed via API keys, ensuring secure access to the data endpoints.
Developers benefit from the API's ability to serve content in multiple languages, making it suitable for global applications. It supports different recitations, which can be critical for applications catering to specific user preferences or educational contexts. The service aims to simplify the process of incorporating Quranic data, removing the need for developers to manage large datasets themselves. This allows development teams to focus on user experience and application logic, rather than data acquisition and maintenance. The provided documentation includes code examples in several popular programming languages, assisting with quick integration and reducing the learning curve for new users.
Quran Cloud's offerings extend beyond basic text retrieval, including features for searching the Quran, accessing tafsir (exegesis), and managing bookmarks programmatically. This comprehensive approach supports advanced application functionalities, such as personalized study tools or community platforms where users can share insights on specific verses. The API infrastructure is designed for scalability, accommodating projects from small personal apps to larger commercial deployments, with tiered pricing reflecting different request volumes. This makes it a viable option for a wide spectrum of development needs involving the Quran.
Key features
- Quranic Text Access: Provides the complete text of the Quran, organized by Surah and Ayah, for display in applications and websites.
- Multiple Translations: Offers access to various Quran translations in multiple languages, allowing developers to cater to diverse linguistic audiences.
- Audio Recitations: Integrates audio files of different reciters for each Ayah, enabling playback functionality within applications.
- Search Functionality: Supports searching the Quranic text and translations, facilitating the implementation of search features in user-facing applications.
- Tafsir Data: Access to exegesis (Tafsir) for verses, providing deeper contextual understanding for educational or research applications.
- API Key Authentication: Secures API access using unique API keys, ensuring controlled usage and data integrity for developer accounts.
- Cross-Language Examples: Documentation includes code examples in JavaScript, PHP, Python, Ruby, Go, and cURL to aid integration.
Pricing
Quran Cloud offers a free developer plan and multiple paid tiers based on monthly request volume. Pricing is subject to change. The following table represents pricing as of May 2026:
| Plan | Monthly Requests | Monthly Price | Features |
|---|---|---|---|
| Developer | 10,000 | Free | Standard API access, limited rate |
| Starter | 500,000 | $15 | Increased rate limits, standard support |
| Pro | 2,500,000 | $50 | Higher rate limits, priority support |
| Business | 10,000,000 | $150 | Dedicated support, custom rate limits |
For detailed and up-to-date pricing information, refer to the official Quran Cloud pricing page.
Common integrations
- Mobile Applications (iOS/Android): Developers can integrate Quran Cloud APIs into native or cross-platform mobile apps to provide Quranic text, translations, and audio playback.
- Websites and Web Applications: The API can power dynamic Quranic content on websites, including daily verse displays, full Quran browsing, and search functionalities.
- Educational Platforms: Integrate Quranic data into e-learning platforms for Islamic studies, language learning, or comparative textual analysis.
- Smart Home Devices/Voice Assistants: Develop integrations for devices like Amazon Echo or Google Home to recite verses or provide Quranic information on demand.
- Academic Research Tools: Utilize the API for data collection and analysis in academic projects focusing on Quranic studies or linguistics.
Alternatives
When considering APIs for Quranic data, several alternatives offer similar functionalities:
- Aladhan API: Provides prayer times, Qibla direction, and Quranic data, often used for comprehensive Islamic app features.
- Islamic Network API: Offers a suite of Islamic APIs including Quran, Hadith, Prayer Times, and other relevant data.
- Qur'an.com API: Provides access to Quranic text and translations, often used by developers familiar with the Qur'an.com platform.
Additional options for general text and content delivery, though not specific to religious texts, include services like Google Custom Search API for indexing and searching large text corpora, or Amazon Polly for generating speech from text, which could be used to synthesize recitations if specific audio files are unavailable.
Getting started
To begin using the Quran Cloud API, developers typically sign up for an account to obtain an API key. This key is then used to authenticate requests to the API endpoints. The documentation provides examples in various languages, simplifying the initial setup. Below is a basic cURL example to retrieve the first verse of the first Surah (Al-Fatiha) in English translation, demonstrating how to make a request and include the API key.
First, obtain your API key from your Quran Cloud dashboard after registration. Replace YOUR_API_KEY with your actual key in the example.
curl -X GET \
'https://api.qurancloud.com/v1/ayah/1/1/en.asad' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'Accept: application/json'
This cURL command requests data for Ayah 1 of Surah 1, specifically the English translation by Muhammad Asad. The -H 'X-API-KEY: YOUR_API_KEY' header sends your authentication credential, and -H 'Accept: application/json' specifies that the response should be in JSON format. Upon successful execution, the API will return a JSON object containing the requested verse text, translation, and associated metadata. Developers can then parse this JSON response within their application to display the content or integrate it into other functionalities.
For more detailed examples and information on specific endpoints, such as retrieving audio files, searching the Quran, or accessing different translations, developers should consult the official Quran Cloud API documentation.