Telawa API
A free and open Quran API for the Muslim developer community. Quran text, translations, tafsir, audio, duas, qibla and prayer times — all in one place. No API key required.
100% Free
Forever, no payment
No Auth
No keys, no signups
Fast
CDN-cached responses
CORS Open
Use from anywhere
Quick start
Make a GET request to any endpoint below. All responses are JSON with a consistent envelope:
// Success
{ "success": true, "data": ..., "meta": { ... } }
// Error
{ "success": false, "error": "Reason" }Example using fetch:
const res = await fetch("https://telawa.org/api/v1/surahs/1");
const { data } = await res.json();
console.log(data.nameEn); // "Al-Fatihah"Rate limits & caching
100 requests / minute / IP
Search endpoint is 30/min due to its higher cost. Exceeding the limit returns HTTP 429 with a Retry-After header.
Aggressive CDN caching
Quran text, surahs and duas are cached for up to 30 days. Most requests are served from the edge and never hit the database.
Endpoints
Click any endpoint to expand parameters and see an example response.
Attribution
Telawa API is provided as ṣadaqah jāriyah — a continuous charity. You may use it in any project (commercial or non-commercial) without payment.
An attribution link to telawa.org is appreciated but not required. Please make duʿāʾ for the team and contributors.
Support
Found a bug or want to request an endpoint? Contact us.
This API is built on the same database that powers telawa.org. Both will be maintained together for as long as we can.