نماز کے اوقات کا مفت API، بغیر کلید

کسی مقام کے لیے نماز کے اوقات

GET /prayer/api/times

دیے گئے نقاط کے لیے آج کی فجر، طلوع، ظہر، عصر، مغرب اور عشاء، ساتھ کل کی فجر۔ ہر وقت UTC میں ISO 8601 لمحہ ہے۔ جو وقت اس دن اس عرض بلد پر موجود نہ ہو وہ شامل نہیں کیا جاتا۔

پیرامیٹرز

lat لازمی

اعشاری درجوں میں عرض بلد۔

lng لازمی

اعشاری درجوں میں طول بلد۔

method اختیاری

حساب کے طریقے کی شناخت، مثلاً muslim-world-league، north-america یا karachi۔ طے شدہ: قریب ترین شہر کا طریقہ۔

madhab اختیاری

Hanafi یا Shafi، جو عصر کا وقت طے کرتا ہے۔ طے شدہ: قریب ترین شہر کے ملک کا عام طریقہ۔

hlr اختیاری

بلند عرض البلد کا اصول: auto، middle-of-the-night، seventh-of-the-night یا twilight-angle۔ ڈیفالٹ: auto۔

fa اختیاری

اپنی مرضی کا فجر زاویہ ڈگری میں، 10 سے 25 تک۔ ڈیفالٹ: طریقے کا اپنا زاویہ۔

ia اختیاری

اپنی مرضی کا عشاء زاویہ ڈگری میں، 10 سے 25 تک۔ ڈیفالٹ: طریقے کا اپنا زاویہ۔

مثال

curl 'https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262'

const res = await fetch('https://qurangallery.com/prayer/api/times?lat=21.4225&lng=39.8262');
const { date, times, fajrTomorrow } = await res.json();

جواب

{
  "date": "2026-10-31",
  "times": [
    { "name": "fajr", "time": "2026-10-31T02:06:00.000Z", "isCurrent": false, "isNext": true },
    { "name": "sunrise", "time": "2026-10-31T03:23:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "dhuhr", "time": "2026-10-31T09:04:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "asr", "time": "2026-10-31T12:20:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "maghrib", "time": "2026-10-31T14:45:00.000Z", "isCurrent": false, "isNext": false },
    { "name": "isha", "time": "2026-10-31T16:15:00.000Z", "isCurrent": false, "isNext": false }
  ],
  "fajrTomorrow": "2026-11-01T02:06:00.000Z"
}

کیلنڈر فیڈ (iCal)

GET /prayer/api/calendar/feed.ics

سبسکرائب کی جا سکنے والی .ics فیڈ جس میں بطورِ طے شدہ اگلے ایک مہینے کے نماز کے اوقات اور اسلامی تقریبات ہیں، اور months پیرامیٹر سے 12 مہینے تک۔ URL کو Google Calendar، Apple Calendar یا Outlook میں کیلنڈر سبسکرپشن کے طور پر شامل کریں۔

پیرامیٹرز

lat لازمی

اعشاری درجوں میں عرض بلد۔

lng لازمی

اعشاری درجوں میں طول بلد۔

method اختیاری

حساب کے طریقے کی شناخت، مثلاً muslim-world-league، north-america یا karachi۔ طے شدہ: قریب ترین شہر کا طریقہ۔

madhab اختیاری

Hanafi یا Shafi، جو عصر کا وقت طے کرتا ہے۔ طے شدہ: قریب ترین شہر کے ملک کا عام طریقہ۔

authority اختیاری

تقریبات کے لیے ہجری کیلنڈر کا ادارہ، مثلاً umm_al_qura یا diyanet۔ طے شدہ: قریب ترین شہر کے ملک کا ادارہ۔

months اختیاری

فیڈ کتنے مہینوں کو شامل کرے، 1 سے 12 تک۔ ڈیفالٹ: 1۔

alarm اختیاری

ہر نماز سے کتنے منٹ پہلے یاد دہانی بجے، 0 سے 120 تک۔ 0 کا مطلب کوئی الارم نہیں۔ ڈیفالٹ: 10۔

a_<prayer> اختیاری

ایک نماز کے لیے الارم کے منٹ، 0 سے 120 تک، جو alarm کی جگہ لیتے ہیں۔ <prayer> کی جگہ fajr، dhuhr، asr، maghrib یا isha لکھیں، جیسے a_fajr=15۔

o_<prayer> اختیاری

ایک نماز کو اتنے منٹ آگے یا پیچھے کریں، -60 سے 60 تک۔ <prayer> کی جگہ fajr، dhuhr، asr، maghrib یا isha لکھیں، جیسے o_isha=5۔ ڈیفالٹ: 0۔

sunrise اختیاری

فیڈ میں طلوعِ آفتاب شامل کرنے کے لیے 1 لکھیں۔ ڈیفالٹ: بند۔

travel اختیاری

ظہر، عصر اور عشاء پر یہ نوٹ شامل کرنے کے لیے 1 لکھیں کہ سفر میں نماز دو رکعت قصر ہوتی ہے۔ ڈیفالٹ: بند۔

ramadan اختیاری

رمضان کے دنوں میں سحری ختم (فجر پر)، افطار (مغرب پر) اور تراویح (عشاء کے 15 منٹ بعد، ایک گھنٹہ) شامل کرنے کے لیے 1 رکھیں۔ دن authority پیرامیٹر کے مطابق ہیں۔ طے شدہ: بند۔

jumuah اختیاری

جمعہ کے دن ظہر کے ایونٹ کا عنوان “جمعہ” کرنے کے لیے 1 رکھیں۔ طے شدہ: بند۔

jumuahLead اختیاری

جمعہ کی یاد دہانی کے لیے اس سے پہلے کے منٹ، 0 سے 120 تک؛ 0 کا مطلب کوئی نہیں۔ جمعہ کے دن ظہر کی یاد دہانی کی جگہ لیتا ہے اور jumuah=1 چاہیے۔ طے شدہ: ظہر کی یاد دہانی۔

busy اختیاری

نماز کے ایونٹس کو مصروف دکھانے کے لیے 1 رکھیں (TRANSP:OPAQUE)۔ ڈیفالٹ: فارغ (TRANSP:TRANSPARENT)۔

hlr اختیاری

بلند عرض البلد کا اصول: auto، middle-of-the-night، seventh-of-the-night یا twilight-angle۔ ڈیفالٹ: auto۔

fa اختیاری

اپنی مرضی کا فجر زاویہ ڈگری میں، 10 سے 25 تک۔ ڈیفالٹ: طریقے کا اپنا زاویہ۔

ia اختیاری

اپنی مرضی کا عشاء زاویہ ڈگری میں، 10 سے 25 تک۔ ڈیفالٹ: طریقے کا اپنا زاویہ۔

مثال

curl 'https://qurangallery.com/prayer/api/calendar/feed.ics?lat=21.4225&lng=39.8262'

جواب

text/calendar (iCalendar) دستاویز جس میں بطورِ طے شدہ ایک مہینے کے واقعات ہیں، months کے ساتھ 12 مہینے تک۔

شہر کی تلاش

GET /prayer/api/location/search

مقام کے نام کو نقاط، ملک کے کوڈ اور ٹائم زون میں بدلتا ہے۔ پہلے ہماری اپنی شہروں کی فہرست میں تلاش ہوتی ہے۔ جس سوال کا کوئی نتیجہ نہ ہو اس پر خالی array ملتا ہے۔

پیرامیٹرز

q لازمی

مقام کا نام، زیادہ سے زیادہ 200 حروف۔

مثال

curl 'https://qurangallery.com/prayer/api/location/search?q=Makkah'

const res = await fetch('https://qurangallery.com/prayer/api/location/search?q=Makkah');
const places = await res.json();

جواب

[
  {
    "lat": 21.4266,
    "lon": 39.8256,
    "displayName": "Makkah, Saudi Arabia",
    "countryCode": "SA",
    "timezone": "Asia/Riyadh"
  }
]

قریبی مساجد

GET /prayer/api/mosques/nearby

کسی نقطے کے گرد مساجد، قریب ترین پہلے، OpenStreetMap کے ڈیٹا سے۔ فاصلہ میٹروں میں ہے۔ نقشے کے ڈیٹا کی خدمات دستیاب نہ ہوں تو جواب 503 ہوتا ہے۔

پیرامیٹرز

lat لازمی

اعشاری درجوں میں عرض بلد۔

lng لازمی

اعشاری درجوں میں طول بلد۔

radius اختیاری

تلاش کا رداس میٹروں میں، 100 سے 50000 تک۔ طے شدہ: 2000۔

مثال

curl 'https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000'

const res = await fetch('https://qurangallery.com/prayer/api/mosques/nearby?lat=21.4225&lng=39.8262&radius=2000');
const mosques = await res.json();

جواب

[
  {
    "id": 1234567,
    "name": "Example Mosque",
    "lat": 21.4231,
    "lng": 39.8269,
    "address": "Example Street 12",
    "distance": 96.4
  }
]

درخواستوں کی حد

حد ہر IP پتے کے لیے ایک منٹ کی کھڑکی میں درخواستیں گنتی ہے۔ حد کے بعد HTTP 429 ملتا ہے۔

• نماز کے اوقات: اس کی اپنی کوئی حد نہیں۔ ہر صفحے کی visit پر کال کرنے کے بجائے ہر مقام کا جواب دن بھر کے لیے محفوظ رکھیں۔
• کیلنڈر فیڈ: 30 درخواستیں فی منٹ۔
• شہر کی تلاش اور قریبی مساجد ایک ہی حد بانٹتے ہیں: 30 درخواستیں فی منٹ۔