Skip to content

cloudkuimages/cloudku-murotal-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Murotal API

GitHub stars GitHub forks GitHub issues GitHub license npm version

Powerful and efficient API for accessing Quranic recitations (Murotal) with comprehensive features and easy integration.

🚀 Features

  • Complete Quran Recitations - Access full Quran audio from various renowned reciters
  • Multiple Reciters - Choose from different qaris with high-quality audio
  • Surah & Verse Access - Get specific surahs or individual verses
  • Audio Formats - Multiple audio format support (MP3, etc.)
  • Fast Response - Optimized for speed and reliability
  • Easy Integration - Simple REST API endpoints
  • Comprehensive Metadata - Detailed information about surahs, verses, and reciters

📖 Documentation

Complete API documentation available at: cloudku.us.kg

🛠️ Installation & Usage

NPM Package

npm install cloudku-murotal

Basic Usage

const { MurotalAPI } = require('cloudku-murotal');

const api = new MurotalAPI();
const recitation = await api.getMurotal('abdulbasit', 1);

API Endpoints

GET /api/murotal/{reciter}/{surah}
GET /api/murotal/{reciter}/{surah}/{verse}

NPM Implementation

const { MurotalAPI } = require('cloudku-murotal');

const api = new MurotalAPI({
  baseURL: 'https://cloudku.us.kg'
});

const data = await api.getRecitation({
  reciter: 'abdulbasit',
  surah: 1
});

Response Format

{
  "status": "success",
  "data": {
    "surah": 1,
    "name": "Al-Fatihah",
    "reciter": "Abdul Basit",
    "audio_url": "https://...",
    "duration": "02:30"
  }
}

🔗 Available Endpoints

  • /reciters - List all available reciters
  • /surahs - Get all surah information
  • /murotal/{reciter} - Get all recitations by specific reciter
  • /murotal/{reciter}/{surah} - Get specific surah recitation
  • /search?q={query} - Search reciters or surahs

📱 Contact & Support

🤝 Contributing

  1. Fork this repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open Pull Request

⭐ Show Your Support

If this project helps you, please give it a ⭐ star!

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Developer

© 2025 AlfiDev

Built with ❤️ for the Muslim community


Documentation: cloudku.us.kg | Support: WhatsApp

About

Source Code Cloudku Murotal Api For Everyone

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published