Developers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 1614556800

# 429 Too Many Requests
HTTP/1.1 429 Too Many Requests
Retry-After: 60

{
  "detail": "Rate limit exceeded. Retry after 60 seconds."
}

# Recommended retry logic
async function makeRequest(url, options = {}) {
  try {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      await new Promise(r => setTimeout(r, retryAfter * 1000));
      return makeRequest(url, options);
    }
    
    return response.json();
  } catch (error) {
    console.error('Request failed:', error);
  }
}

npm install @quranicknowledge/api-sdk

import { QuranicAPI } from '@quranicknowledge/api-sdk';

const api = new QuranicAPI({
  baseUrl: 'https://app.tafheemulquran.net/api/v1',
  token: 'your-jwt-token'
});

// Get ayahs from Surah Al-Fatiha
const ayahs = await api.ayahs.getBySurah(1);
console.log(ayahs);

// Create article
const article = await api.articles.create({
  title: 'My Article',
  content: 'Content here...',
  surah_id: 1
});

pip install quranic-api-sdk

from quranic_api import QuranicAPI

api = QuranicAPI(
  base_url='https://app.tafheemulquran.net/api/v1',
    token='your-jwt-token'
)

# Get all surahs
surahs = api.ayahs.get_all(limit=10)

# Search ayahs
results = api.ayahs.search(q='mercy', limit=20)

# Get Surah Al-Fatiha ayahs
curl -X GET \
  'https://app.tafheemulquran.net/api/v1/ayahs/surah/1' \
  -H 'Accept: application/json'

# Create article (requires authentication)
curl -X POST \
  'https://app.tafheemulquran.net/api/v1/articles' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Article Title",
    "content": "Article content...",
    "surah_id": 1
  }'