{"id":9112,"date":"2026-10-07T04:30:18","date_gmt":"2026-10-06T23:00:18","guid":{"rendered":"https:\/\/mathuranow.in\/?page_id=9112"},"modified":"2026-10-31T05:10:41","modified_gmt":"2026-10-30T23:40:41","slug":"panchang-api","status":"publish","type":"page","link":"https:\/\/mathuranow.in\/hi\/panchang-api\/","title":{"rendered":"\u092e\u0941\u092b\u093c\u094d\u0924 \u092c\u094d\u0930\u091c \u092a\u0902\u091a\u093e\u0902\u0917 \u0914\u0930 \u0930\u093e\u0936\u093f\u092b\u0932 \u090f\u092a\u0940\u0906\u0908 (\u0939\u093f\u0902\u0926\u0940 + \u0905\u0902\u0917\u094d\u0930\u0947\u091c\u0940 JSON)"},"content":{"rendered":"

MathuraNow publishes the day’s Braj \/ Mathura-Vrindavan Panchang and a daily Rashifal.<\/strong> This free API gives websites, apps and bots the same data as simple static JSON files, in Hindi and English: no key, no sign-up, nothing to install.<\/p>\n

What it is, honestly:<\/strong> the Panchang is for Mathura \/ Braj and is entered every day by a named author on our team. The Rashifal is drafted with AI help and published only after a person has read and approved it. It is not an all-India Panchang calculator<\/strong>. Free for non-commercial use with attribution (CC BY-NC 4.0); please show the credit line given below.<\/p>\n

Quick start (5 minutes)<\/h2>\n
    \n
  1. Fetch a file.<\/strong> It is a plain GET<\/code>; no key. Try it in a terminal:\n
    curl -s https:\/\/mathuranow.in\/api\/v1\/panchang\/today.en.json<\/code><\/pre>\n<\/li>\n
  2. Check status<\/code>.<\/strong> Use the data only when status<\/code> is \"published\"<\/code>. While it is \"pending\"<\/code>, show nothing or “coming soon”.<\/li>\n
  3. Read the values<\/strong> from data.fields<\/code> (Panchang) or data.signs<\/code> (Rashifal).<\/li>\n
  4. Show the credit<\/strong> (attribution_html<\/code>) next to the data, and the note<\/code> with the Rashifal.<\/li>\n<\/ol>\n
    fetch('https:\/\/mathuranow.in\/api\/v1\/panchang\/today.en.json')\n  .then(function (r) { return r.json(); })\n  .then(function (d) {\n    if (d.status !== 'published') { return; }          \/\/ placeholder until the author submits\n    console.log(d.data.fields.tithi, d.data.fields.sunrise);\n    document.getElementById('credit').innerHTML = d.attribution_html;\n  });<\/code><\/pre>\n
    Prefer no code at all? Use the embed widget<\/a>.<\/p>\n
    Embed widget (copy-paste)<\/h2>\n
    One static script, no dependencies, about 8 KB. Paste the two lines below where you want the widget. It reads only the static “today” files, shows “Coming soon” while the day’s entry is pending, never breaks your page if something fails, and always shows a visible “by MathuraNow” credit link.<\/p>\n
    Live demo<\/strong> (Panchang in English, Rashifal in Hindi with the dark theme):<\/p>\n
    \n
    <\/div>\n
    <\/div>\n<\/div>\n
    Copy this:<\/strong><\/p>\n
    <div data-mathuranow-widget=\"panchang\" data-lang=\"en\"><\/div>\n<script src=\"https:\/\/mathuranow.in\/api\/v1\/widget.js\" async><\/script><\/code><\/pre>\n
    \n\n\n\n\n\n\n\n
    Attribute<\/th>\nValues<\/th>\nMeaning<\/th>\n<\/tr>\n<\/thead>\n
    data-mathuranow-widget<\/code><\/td>\npanchang<\/code> | rashifal<\/code><\/td>\nWhich widget. The Rashifal widget has a 12-sign picker.<\/td>\n<\/tr>\n
    data-lang<\/code><\/td>\nen<\/code> | hi<\/code><\/td>\nLanguage. If omitted, the page’s lang<\/code> attribute is used (default English).<\/td>\n<\/tr>\n
    data-theme<\/code><\/td>\nlight<\/code> (default) | dark<\/code> | auto<\/code><\/td>\nColours. auto<\/code> follows the visitor’s light \/ dark setting.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
    You may put several widgets on one page; load the script once. Please keep the credit link visible: it is the licence condition.<\/p>\n
    Endpoints<\/h2>\n
    All endpoints are plain GET<\/code> requests. Replace YYYY-MM-DD<\/code> with a date such as 2026-10-14<\/code>. A dated file exists only for dates that have a published entry (otherwise HTTP 404).<\/p>\n
    GET<\/b>https:\/\/mathuranow.in\/api\/v1\/panchang\/today.en.json<\/code><\/div>\n
    GET<\/b>https:\/\/mathuranow.in\/api\/v1\/panchang\/today.hi.json<\/code><\/div>\n
    GET<\/b>https:\/\/mathuranow.in\/api\/v1\/panchang\/YYYY-MM-DD.en.json<\/code><\/div>\n
    GET<\/b>https:\/\/mathuranow.in\/api\/v1\/rashifal\/today.en.json<\/code><\/div>\n
    GET<\/b>https:\/\/mathuranow.in\/api\/v1\/rashifal\/today.hi.json<\/code><\/div>\n
    GET<\/b>https:\/\/mathuranow.in\/api\/v1\/rashifal\/YYYY-MM-DD.hi.json<\/code><\/div>\n
    The Hindi and English variants (.hi.json<\/code> \/ .en.json<\/code>) exist for every date and both endpoints. The files send Access-Control-Allow-Origin: *<\/code>, so you can call them straight from a browser. A machine-readable description is available as openapi.json<\/code><\/a> (OpenAPI 3.1).<\/p>\n
    Field reference<\/h2>\n
    Envelope<\/strong> (every file):<\/p>\n
    \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Field<\/th>\nType<\/th>\nMeaning<\/th>\n<\/tr>\n<\/thead>\n
    version<\/code><\/td>\nstring<\/td>\nAlways \"v1\"<\/code>.<\/td>\n<\/tr>\n
    widget<\/code><\/td>\nstring<\/td>\n\"panchang\"<\/code> or \"rashifal\"<\/code>.<\/td>\n<\/tr>\n
    date<\/code><\/td>\nstring<\/td>\nThe IST day the entry is for, YYYY-MM-DD<\/code>.<\/td>\n<\/tr>\n
    lang<\/code><\/td>\nstring<\/td>\n\"en\"<\/code> or \"hi\"<\/code>.<\/td>\n<\/tr>\n
    status<\/code><\/td>\nstring<\/td>\n\"published\"<\/code> or \"pending\"<\/code> (see below).<\/td>\n<\/tr>\n
    updated<\/code><\/td>\nstring or null<\/td>\nWhen the entry was last saved (UTC, ISO 8601). null<\/code> while pending.<\/td>\n<\/tr>\n
    expires<\/code><\/td>\nstring or null<\/td>\n“Today” files only: the next IST midnight (UTC). null<\/code> in dated files.<\/td>\n<\/tr>\n
    data<\/code><\/td>\nobject or null<\/td>\nThe entry. null<\/code> while pending.<\/td>\n<\/tr>\n
    credit<\/code><\/td>\nobject or null<\/td>\nThe named author: name<\/code>, photo_url<\/code>, author_url<\/code>. Never an e-mail address.<\/td>\n<\/tr>\n
    source<\/code>, source_url<\/code><\/td>\nstring<\/td>\n\"MathuraNow\"<\/code> and https:\/\/mathuranow.in\/<\/code>.<\/td>\n<\/tr>\n
    license<\/code><\/td>\nstring<\/td>\n\"CC BY-NC 4.0\"<\/code>.<\/td>\n<\/tr>\n
    attribution_html<\/code><\/td>\nstring<\/td>\nA ready credit line (HTML). Show it with the data.<\/td>\n<\/tr>\n
    terms<\/code><\/td>\nstring<\/td>\nShort terms of use.<\/td>\n<\/tr>\n
    note<\/code><\/td>\nstring<\/td>\nRashifal only: the disclosure to show with the text.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
    Panchang data<\/code><\/strong>:<\/p>\n
    \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Field<\/th>\nMeaning<\/th>\n<\/tr>\n<\/thead>\n
    fields.vaar<\/code><\/td>\nWeekday.<\/td>\n<\/tr>\n
    fields.tithi<\/code><\/td>\nTithi, with its end time in free text.<\/td>\n<\/tr>\n
    fields.nakshatra<\/code><\/td>\nNakshatra, with its end time.<\/td>\n<\/tr>\n
    fields.yoga<\/code><\/td>\nYoga, with its end time.<\/td>\n<\/tr>\n
    fields.karana<\/code><\/td>\nKarana, with end times.<\/td>\n<\/tr>\n
    fields.chandra_rashi<\/code><\/td>\nMoon sign.<\/td>\n<\/tr>\n
    fields.muhurat<\/code><\/td>\nAuspicious periods of the day.<\/td>\n<\/tr>\n
    fields.rahu_kaal<\/code>, fields.yamaganda<\/code>, fields.gulika_kaal<\/code><\/td>\nThe three inauspicious periods, as time ranges.<\/td>\n<\/tr>\n
    fields.sunrise<\/code>, fields.sunset<\/code><\/td>\nSunrise and sunset time.<\/td>\n<\/tr>\n
    extra[]<\/code><\/td>\nExtra items the author adds, each { \"key\", \"label\", \"value\" }<\/code>, for example bhadra<\/code>, panchak<\/code>, ganda_moola<\/code>, disha_shool<\/code>, moonrise<\/code>, moonset<\/code>. The keys can vary by day.<\/td>\n<\/tr>\n
    muhurat.shubh[]<\/code>, muhurat.ashubh[]<\/code><\/td>\nThe same Muhurat values grouped as on the website, each { \"key\", \"label\", \"value\" }<\/code>, in the order the author saved them. shubh<\/code>: auspicious periods. ashubh<\/code>: inauspicious periods (Rahu Kaal, Yamaganda, Gulika Kaal, and when the author adds them Dur Muhurat, Varjyam, Bhadra, Panchak, Ganda Moola, Disha Shool). The values are also in fields<\/code> and extra[]<\/code>.<\/td>\n<\/tr>\n
    note<\/code><\/td>\nOptional. A short note the author wrote for the day, in the language of the file. Present only when filled.<\/td>\n<\/tr>\n
    ai<\/code><\/td>\ntrue<\/code> when the entry was drafted with AI help.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
    All values are free text as the author entered them, in the language of the file, and any field can be missing when it was left empty. Show them as text; please do not rely on parsing them.<\/p>\n
    Rashifal data<\/code><\/strong>:<\/p>\n
    \n\n\n\n\n\n\n\n\n
    Field<\/th>\nMeaning<\/th>\n<\/tr>\n<\/thead>\n
    assisted<\/code><\/td>\ntrue<\/code> when drafted with AI help (then human-reviewed).<\/td>\n<\/tr>\n
    signs[]<\/code><\/td>\n12 items in the traditional order: key<\/code> (aries<\/code> to pisces<\/code>), name<\/code> (in the file’s language), text<\/code>, and ai<\/code>.<\/td>\n<\/tr>\n
    note<\/code><\/td>\nOptional. A short note the author wrote for the day, in the language of the file. Present only when filled. (Not the same as the top-level note<\/code>, which is the Rashifal disclosure.)<\/td>\n<\/tr>\n
    methodology_url<\/code><\/td>\nThe page that explains how the Rashifal is prepared.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
    Sample response<\/h2>\n
    A Panchang file (values shortened; the values below are an illustration):<\/p>\n
    {\n  \"version\": \"v1\",\n  \"widget\": \"panchang\",\n  \"date\": \"2026-10-14\",\n  \"lang\": \"en\",\n  \"status\": \"published\",\n  \"updated\": \"2026-10-13T15:31:57+00:00\",\n  \"expires\": \"2026-10-14T18:30:00+00:00\",\n  \"data\": {\n    \"fields\": {\n      \"vaar\": \"...\",\n      \"tithi\": \"...\",\n      \"nakshatra\": \"...\",\n      \"sunrise\": \"...\",\n      \"sunset\": \"...\",\n      \"rahu_kaal\": \"...\"\n    },\n    \"extra\": [ { \"key\": \"moonrise\", \"label\": \"Moonrise\", \"value\": \"...\" } ],\n    \"ai\": false\n  },\n  \"credit\": {\n    \"name\": \"Author name\",\n    \"photo_url\": \"https:\/\/mathuranow.in\/...\",\n    \"author_url\": \"https:\/\/mathuranow.in\/newsdesk\/...\"\n  },\n  \"source\": \"MathuraNow\",\n  \"source_url\": \"https:\/\/mathuranow.in\/\",\n  \"license\": \"CC BY-NC 4.0\",\n  \"attribution_html\": \"Source: <a href=\"https:\/\/mathuranow.in\/\" rel=\"noopener\">MathuraNow<\/a> &middot; Author name\",\n  \"terms\": \"Free for non-commercial use with attribution. Fair use applies. Terms may change with 30 days' notice.\"\n}<\/code><\/pre>\n
    When status is “pending”<\/h2>\n
    Before the author has submitted the day’s entry, the “today” file is a placeholder: \"status\": \"pending\"<\/code>, \"data\": null<\/code>, \"updated\": null<\/code>. It never shows yesterday’s data. Show nothing, or a “coming soon” message, and check again later. The expires<\/code> field is the next midnight IST.<\/p>\n
    {\n  \"version\": \"v1\",\n  \"widget\": \"panchang\",\n  \"date\": \"2026-10-15\",\n  \"lang\": \"en\",\n  \"status\": \"pending\",\n  \"updated\": null,\n  \"expires\": \"2026-10-15T18:30:00+00:00\",\n  \"data\": null,\n  \"credit\": null\n}<\/code><\/pre>\n
    (The remaining envelope fields are as in the sample above.)<\/p>\n
    Update time and caching<\/h2>\n
    The author enters the next day’s Panchang, and then the Rashifal, the evening before (target 11:00 PM IST). At 12:00 AM IST<\/strong> that entry becomes the “today” entry: the “today” files switch to it on their own. If no entry has been submitted for the new day, the “today” files show a placeholder (\"status\": \"pending\"<\/code>) until it is. The dated file of an entry changes within seconds of each submission, and again if the author edits it.<\/p>\n