Getting Started with IslamiCloud API

Sign up for an IslamiCloud account and create your first application. Each app gets its own API key with access to all 10 API modules.

• Visit the IslamiCloud Dashboard
• Create a new application
• Copy your Bearer token from the API Keys section
• Each subscription covers one app with unlimited module access

All API endpoints require Bearer token authentication. Add your API key to the Authorization header of every request.

// Add to every request
headers: {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
}

Try a simple endpoint to verify everything works. The Hadith of the Day endpoint is a great starting point.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.islamicloud.com/api/hadiths/day

All responses follow a consistent JSON format with code, status, and data fields. Error responses include an error message with HTTP status codes.

// Success Response
{
  "code": 200,
  "status": "OK",
  "data": { ... }
}

// Error Response  
{
  "error": "Missing required parameter: latitude",
  "details": "..."
}

With one subscription you get access to all 10 API modules. Explore Prayer Times, Qibla, Hadiths, Adhan, Mosques, Media, Radio, Azkar, Images and more.

• Hadiths — Editions, daily hadith, paginated lists, search
• Timings — Prayer times by location and date
• Qibla — Compass direction to Mecca
• Adhan — Audio streams (Sunni/Shia, Regular/Fajr)
• Mosques — Nearby mosques via OpenStreetMap
• Media — Religious IPTV channels
• Radio — Location-based Islamic stations
• Azkar — Before, after, and during prayer
• Images — Islamic images & Image of the Day
• Radio v2 — Predefined station lists