In the name of Allah, the Entirely Merciful, the Especially Merciful, who has guided me to do this work

Welcome to the Tafsir API repository, a comprehensive collection of Quran Tafsirs presented in a REST architectural style. This API is designed to facilitate the development of websites and applications, with the primary aim of spreading the word of God to people around the world.

• Free & Lightning-Fast: Our API provides free access to Quran Tafsirs with blazing-fast response times.
• No Rate Limits: There are no rate limits imposed on API usage, ensuring unrestricted access to the content.
• Multilingual Support: The API offers Tafsirs in various languages.
• 122 Tafsirs: Access 122 different Tafsirs to explore Quranic interpretations.

• https://cdn.jsdelivr.net/gh/spa5k/tafsir_api@{apiVersion}/{endpoint}

Versioning - By default, it uses main branch, which you can use as @main or @v1 etc. You can also use commit hash as versioning.

1. JS Delivr: https://cdn.jsdelivr.net/gh/spa5k/tafsir_api@main/tafsir
2. Git Hack: https://rawcdn.githack.com/spa5k/tafsir_api/bf42646e16973c59a0789b7a3ad065ff6ad6b0bf/tafsir
3. Staticaly: https://cdn.statically.io/gh/spa5k/tafsir_api/main/tafsir
4. Github: https://raw.githubusercontent.com/spa5k/tafsir_api/main/tafsir
5. Gitloaf: https://gitloaf.com/cdn/spa5k/tafsir_api/main/tafsir

You can and should download data and tafsir folders and host it yourself (instead of depending only on public CDNs).

Required folders to host:

• data/**
• tafsir/**

Quick start:

git clone --depth 1 https://github.com/spa5k/tafsir_api.git
cd tafsir_api

Then upload/serve the data/ folder from your own static hosting (Nginx, Cloudflare R2, S3, Vercel static, etc.).

• /editions

  Description: List all available editions.

  https://cdn.jsdelivr.net/gh/spa5k/tafsir_api@main/tafsir/editions.json

• /editions/{editionSlug}/{surahNumber}

  Description: Fetch specific edition's Surahs with their Ayahs.

  Example URL: https://cdn.jsdelivr.net/gh/spa5k/tafsir_api@main/tafsir/en-al-jalalayn/1.json

• /editions/{editionSlug}/{surahNumber}/{ayahNumber}

  Description: Fetch a specific edition's Surahs with their Ayahs.

  Example URL: https://cdn.jsdelivr.net/gh/spa5k/tafsir_api@main/tafsir/en-al-jalalayn/1/1.json

• /editions/{editionSlug}/{surahNumber}/empty_ayahs.json

  Description: Fetch the specific edition's Surahs that contain empty Ayahs.

  Example URL: https://cdn.jsdelivr.net/gh/spa5k/tafsir_api@main/tafsir/en-al-qushairi-tafsir/2/empty_ayahs.json

Please Share this repo with your fellow mates and Star this repo by clicking on ⭐ button above ↗️

We welcome contributions to enhance the API with more Tafsirs and additional features. If you're interested in contributing, please refer to the contribution guidelines for detailed instructions on how to add more Tafsirs.

You can check https://github.com/spa5k/tafsir_api/blob/main/internal/strategies/quran_strategy.go for more info on how to add more Tafsirs.

Thank you for being a part of our mission to spread the message of God to the world.

• Hadith API
• Quran API

Some tafsirs, such as Fi Zilal al-Qur'an by Sayyid Qutb, were removed due to reports of problematic aqeedah by some users #25