मुफ़्त ब्रज पंचांग और राशिफल एपीआई (हिंदी + अंग्रेजी JSON)

त्वरित शुरुआत (5 मिनट)

1. एक फ़ाइल प्राप्त करें। यह एक सादा GET; कोई कुंजी नहीं चाहिए। इसे टर्मिनल में आज़माएँ:

   curl -s https://mathuranow.in/api/v1/panchang/today.en.json

2. जाँचें status. डेटा का उपयोग केवल तभी करें जब status है "published"जबकि यह है "pending"कुछ भी न दिखाएं या "जल्द आ रहा है" दिखाएं।
3. मानों को पढ़ें से data.fields (पंचांग) या data.signs (राशिफल)।
4. श्रेय दिखाएँ (attribution_html) डेटा के बगल में, और note राशिफल के साथ।

fetch('https://mathuranow.in/api/v1/panchang/today.en.json')
  .then(function (r) { return r.json(); })
  .then(function (d) {
    if (d.status !== 'published') { return; }          // placeholder until the author submits
    console.log(d.data.fields.tithi, d.data.fields.sunrise);
    document.getElementById('credit').innerHTML = d.attribution_html;
  });

क्या आप बिल्कुल भी कोड का इस्तेमाल नहीं करना चाहते? तो एम्बेड विजेट का उपयोग करें।

विजेट एम्बेड करें (कॉपी-पेस्ट करें)

एक ही स्टैटिक स्क्रिप्ट, बिना किसी डिपेंडेंसी के, लगभग 8 KB की। नीचे दी गई दो पंक्तियों को वहाँ पेस्ट करें जहाँ आप विजेट लगाना चाहते हैं। यह केवल स्टैटिक "today" फ़ाइलों को पढ़ता है, दिन की एंट्री पेंडिंग होने तक "Coming soon" दिखाता है, किसी गड़बड़ी की स्थिति में आपका पेज क्रैश नहीं होता, और हमेशा "by मथुरा नाउ" क्रेडिट लिंक दिखाता है।

लाइव डेमो (अंग्रेज़ी में पंचांग, डार्क थीम के साथ हिंदी में राशिफल):

इसे कॉपी करें:

<div data-mathuranow-widget="panchang" data-lang="en"></div>
<script src="https://mathuranow.in/api/v1/widget.js" async></script>

आप एक पेज पर कई विजेट लगा सकते हैं; स्क्रिप्ट को केवल एक बार लोड करें। कृपया क्रेडिट लिंक को प्रदर्शित रखें: यह लाइसेंस की शर्त है।

अंतिमबिंदुओं

सभी अंतिम बिंदु सादे हैं GET अनुरोध। बदलें YYYY-MM-DD किसी तिथि के साथ जैसे कि 2026-10-14दिनांकित फ़ाइल केवल उन्हीं तिथियों के लिए मौजूद होती है जिनके लिए प्रकाशित प्रविष्टि उपलब्ध हो (अन्यथा HTTP 404 त्रुटि दिखाई देगी)।

प्रत्येक तिथि और दोनों एंडपॉइंट्स के लिए हिंदी और अंग्रेजी संस्करण ( .hi.json / .en.json ) उपलब्ध हैं। ये फ़ाइलें Access-Control-Allow-Origin: * भेजती हैं, इसलिए आप इन्हें सीधे ब्राउज़र से एक्सेस कर सकते हैं। मशीन-पठनीय विवरण openapi.json (OpenAPI 3.1) के रूप में उपलब्ध है।

फ़ील्ड संदर्भ

एन्वेलप (Envelope) (प्रत्येक फ़ाइल):

पंचांग data:

सभी मान लेखक द्वारा दर्ज किए गए अनुसार मुक्त पाठ के रूप में हैं, फ़ाइल की भाषा में, और कोई भी फ़ील्ड खाली छोड़े जाने पर अनुपलब्ध हो सकता है। कृपया इन्हें पाठ के रूप में प्रदर्शित करें; इन्हें पार्स करने पर निर्भर न रहें।

rashifal data:

नमूना प्रतिक्रिया

एक पंचांग फाइल (मान संक्षिप्त किए गए हैं; नीचे दिए गए मान केवल उदाहरण के लिए हैं):

{
  "version": "v1",
  "widget": "panchang",
  "date": "2026-10-14",
  "lang": "en",
  "status": "published",
  "updated": "2026-10-13T15:31:57+00:00",
  "expires": "2026-10-14T18:30:00+00:00",
  "data": {
    "fields": {
      "vaar": "...",
      "tithi": "...",
      "nakshatra": "...",
      "sunrise": "...",
      "sunset": "...",
      "rahu_kaal": "..."
    },
    "extra": [ { "key": "moonrise", "label": "Moonrise", "value": "..." } ],
    "ai": false
  },
  "credit": {
    "name": "Author name",
    "photo_url": "https://mathuranow.in/...",
    "author_url": "https://mathuranow.in/newsdesk/..."
  },
  "source": "MathuraNow",
  "source_url": "https://mathuranow.in/",
  "license": "CC BY-NC 4.0",
  "attribution_html": "Source: <a href="https://mathuranow.in/" rel="noopener">MathuraNow</a> &middot; Author name",
  "terms": "Free for non-commercial use with attribution. Fair use applies. Terms may change with 30 days' notice."
}

जब status “pending” (लंबित) हो

लेखक द्वारा दिन की प्रविष्टि जमा करने से पहले, "आज" फ़ाइल एक प्लेसहोल्डर होती है: "status": "pending", "data": null, "updated": nullयह कल का डेटा कभी नहीं दिखाता। या तो कुछ भी न दिखाएं, या "जल्द आ रहा है" संदेश दिखाएं, और बाद में दोबारा जांच करें। expires यह फ़ील्ड अगले मध्यरात्रि IST का समय है।

{
  "version": "v1",
  "widget": "panchang",
  "date": "2026-10-15",
  "lang": "en",
  "status": "pending",
  "updated": null,
  "expires": "2026-10-15T18:30:00+00:00",
  "data": null,
  "credit": null
}

(बाक़ी एन्वेलप फ़ील्ड ऊपर के नमूने जैसे ही हैं।)

अपडेट समय और कैशिंग

लेखक अगले दिन का पंचांग और उसके बाद राशिफल एक शाम पहले (लक्ष्य: रात 11:00 बजे भारतीय समयानुसार) दर्ज करता है। भारतीय समयानुसार रात 12:00 बजे (12:00 AM IST) वह प्रविष्टि "आज" की प्रविष्टि बन जाती है: "आज" वाली फाइलें स्वतः ही उस प्रविष्टि में परिवर्तित हो जाती हैं। यदि नए दिन के लिए कोई प्रविष्टि जमा नहीं की गई है, तो "आज" वाली फाइलें एक प्लेसहोल्डर दिखाती हैं।"status": "pending"जब तक ऐसा न हो जाए। किसी प्रविष्टि की दिनांकित फ़ाइल प्रत्येक सबमिशन के कुछ ही सेकंडों के भीतर बदल जाती है, और यदि लेखक इसे संपादित करता है तो यह फिर से बदल जाती है।

• today.*.json: Cache-Control: public, max-age=300 (अधिकतम 5 मिनट तक)।
• दिनांकित फाइलें, openapi.json और widget.js: public, max-age=3600 (अधिकतम 1 घंटे तक)।
• कृपया अपनी ओर से कम से कम 5 मिनट के लिए कैशिंग करें, बार-बार पोलिंग न करें और यादृच्छिक क्वेरी स्ट्रिंग न जोड़ें। expires यह जानने के लिए कि "आज" कब समाप्त होता है।

उदाहरण प्राप्त करें

PHP (अपने सिस्टम पर कुछ मिनटों के लिए परिणाम को कैश करें):

<?php
$json = file_get_contents('https://mathuranow.in/api/v1/rashifal/today.en.json');
$d    = json_decode($json, true);
if (($d['status'] ?? '') === 'published') {
    foreach ($d['data']['signs'] as $sign) {
        echo $sign['name'] . ': ' . $sign['text'] . "n";
    }
    echo $d['note'] . "n" . $d['attribution_html'];
}

अधिक उदाहरण (HTML विजेट, जावास्क्रिप्ट, PHP) ओपनएपीआई फ़ाइल के साथ सार्वजनिक रिपॉजिटरी में उपलब्ध हैं: github.com/himanshu-ag-2026/mathuranow-panchang-api ।

लाइसेंस और श्रेय

यह डेटा CC BY-NC 4.0 (क्रिएटिव कॉमन्स एट्रीब्यूशन-नॉन-कमर्शियल 4.0) लाइसेंस के तहत लाइसेंस प्राप्त है। कृपया जहां भी डेटा प्रदर्शित हो, हमें श्रेय दें। प्रत्येक फ़ाइल में attribution_html में एक तैयार पंक्ति शामिल है। श्रेय पंक्ति को कॉपी-पेस्ट करें:

Source: <a href="https://mathuranow.in/" rel="noopener">MathuraNow</a> &middot; Author name

mathuranow.in का लिंक हमेशा दिखाई देना चाहिए और इसे छिपाया या "नोफ़ॉलो" के रूप में चिह्नित नहीं किया जाना चाहिए जिससे इसका श्रेय हट जाए। एम्बेड विजेट में यह पहले से ही शामिल है।

वाणिज्यिक उपयोग / लाइसेंसिंग

डेटा का व्यावसायिक उपयोग, पुनर्विक्रय या अपने नाम से पुनर्प्रकाशन करने के लिए हमारी लिखित अनुमति आवश्यक है। कृपया हमें लिखें। editor@mathuranow.in और हमें यह भी बताएं कि आप क्या बनाने की योजना बना रहे हैं।

वाणिज्यिक उपयोग/लाइसेंसिंग: editor@mathuranow.in

राशिफल के बारे में

राशिफल कृत्रिम बुद्धिमत्ता की सहायता से तैयार किया जाता है और इसकी समीक्षा मानव द्वारा की जाती है: इसे उस दिन के सत्यापित पंचांग से तैयार किया जाता है और किसी व्यक्ति द्वारा पढ़े, संपादित और अनुमोदित किए जाने के बाद ही प्रकाशित किया जाता है। प्रत्येक राशिफल फाइल में यह टिप्पणी होती है। “एआई की सहायता से निर्मित, मानव द्वारा समीक्षित। आस्था और मनोरंजन के लिए।” कृपया इसे राशिफल के साथ दिखाएं। यह पेशेवर, चिकित्सा, कानूनी या वित्तीय सलाह नहीं है।

शर्तें

गैर-व्यावसायिक उपयोग के लिए, श्रेय देने के साथ यह निःशुल्क है। उचित उपयोग लागू होता है। नियम और शर्तें 30 दिन के पूर्व सूचना के साथ बदल सकती हैं। डेटा बिना किसी उपलब्धता की गारंटी के, यथावत प्रदान किया जाता है, और हम सेवा को नुकसान पहुंचाने वाले किसी भी एक्सेस को सीमित या अवरुद्ध कर सकते हैं। कृपया हमारी पंचांग फ़ीड उपयोग नीति भी देखें।

परिवर्तन सूची (Changelog)

• 2026-10-14 (v1.1): एम्बेड विजेट (widget.js), ओपनएपीआई 3.1 विवरण, पूर्ण फ़ील्ड संदर्भ, सार्वजनिक उदाहरण भंडार, लाइसेंसिंग संपर्क।
• 2026-10-07 (v1.0): पहला संस्करण: ब्रज पंचांग और राशिफल के लिए स्थिर JSON today और दिनांकित फाइलें, अंग्रेजी और हिंदी में।

प्रश्न या बग रिपोर्ट के लिए: editor@mathuranow.in पर संपर्क करें।