Skip to main content

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.

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 APIs
  • ImageQuran 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 ID
  • User 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 --yes

  • JavaScript / 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 SDK
  • Direct 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
Quran App Store

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.