Quran For Devs
Build with trusted content. Keep users connected.
Add Quran content and connected user features to your app with Quran Foundation APIs and Quran ID. Create and manage your app through Developer Console.
Already building? Open Developer Console.
What will you add to your app?
Content APIs
Build with trusted Quran content
Access Quran text, translations, tafsir, and recitations. Scholarly verified content, maintained through corrections and feedback, with respect for source rights.
Users do not need to sign in to read content in your app.
Start with Content APIsQuran ID
Connect one account across apps
Let users sign in with Quran ID across Quran.com, Quran Apps, and connected apps. Pair it with User APIs so supported progress and features can follow them, with their permission.
Built on OAuth2 and OpenID Connect.
Integrate Quran IDUser APIs
Help users pick up where they left off
Connect notes, bookmarks, reflections, reading history, streaks, collections, and more. Add the features that support your app’s purpose and your users’ Quran journey.
Requires Quran ID and permission to access the relevant features.
Explore User APIs
Choose how to build
Create your app in Developer Console, then start with a template, use an SDK, or call the APIs directly.
Next.js starter
Start with a working Next.js app
Customize a starter with Quran ID sign-in, a reader, notes, and bookmarks already connected.
First, create a Backend/server app in Developer Console and save its client secret. The starter’s search feature needs separate pre-live permission.
npx @quranjs/create-app@latest my-quran-app --template next --package-manager npm --install --git --sdk-source npm --yesJavaScript / TypeScript SDK
Add APIs to your existing app
Use the JavaScript / TypeScript SDK for Content APIs, Quran ID integration, and User APIs. Follow the setup for your app type.
Use the SDKDirect API integration
Build with your preferred stack
Use the API reference and integration guides to connect your app directly. Follow the Quran ID guide when you need user sign-in.
Browse API reference Quran ID: OAuth2/OIDC guide
Build toward a connected Quran experience
Aim for Transformational status by combining Quran ID with features that support meaningful progress. Follow the Connected Apps guide and submit your app for Quran App Store review through Developer Console.
Need help with your integration?
Manage credentials and permissions in Developer Console. For integration or review questions, contact our developer team.