Free Braj Panchang & Rashifal API (Hindi + English JSON)

Quick start (5 minutes)

1. Fetch a file. It is a plain GET; no key. Try it in a terminal:

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

2. Check status. Use the data only when status is "published". While it is "pending", show nothing or “coming soon”.
3. Read the values from data.fields (Panchang) or data.signs (Rashifal).
4. Show the credit (attribution_html) next to the data, and the note with the Rashifal.

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;
  });

Prefer no code at all? Use the embed widget.

Embed widget (copy-paste)

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.

Live demo (Panchang in English, Rashifal in Hindi with the dark theme):

Copy this:

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

You may put several widgets on one page; load the script once. Please keep the credit link visible: it is the licence condition.

Endpoints

All endpoints are plain GET requests. Replace YYYY-MM-DD with a date such as 2026-10-14. A dated file exists only for dates that have a published entry (otherwise HTTP 404).

The Hindi and English variants (.hi.json / .en.json) exist for every date and both endpoints. The files send Access-Control-Allow-Origin: *, so you can call them straight from a browser. A machine-readable description is available as openapi.json (OpenAPI 3.1).

Field reference

Envelope (every file):

Panchang data:

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.

Rashifal data:

Sample response

A Panchang file (values shortened; the values below are an illustration):

{
  "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."
}

When status is “pending”

Before the author has submitted the day’s entry, the “today” file is a placeholder: "status": "pending", "data": null, "updated": null. It never shows yesterday’s data. Show nothing, or a “coming soon” message, and check again later. The expires field is the next midnight 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
}

(The remaining envelope fields are as in the sample above.)

Update time and caching

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 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") until it is. The dated file of an entry changes within seconds of each submission, and again if the author edits it.

• today.*.json: Cache-Control: public, max-age=300 (up to 5 minutes).
• Dated files, openapi.json and widget.js: public, max-age=3600 (up to 1 hour).
• Please cache on your side for at least 5 minutes, do not poll more often, and do not add random query strings. Use expires to know when “today” ends.

Fetch examples

PHP (cache the result for a few minutes on your side):

<?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'];
}

More examples (HTML widget, JavaScript, PHP) are in the public repository, together with the OpenAPI file: github.com/himanshu-ag-2026/mathuranow-panchang-api.

License and attribution

The data is licensed under CC BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0). Please credit us wherever the data is shown. Each file contains a ready-made line in attribution_html. Copy-paste credit line:

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

The link back to mathuranow.in must stay visible and must not be hidden or marked “nofollow” in a way that removes the credit. The embed widget already includes it.

Commercial use / licensing

Commercial use, resale, or republishing the data as your own needs our written permission. Write to editor@mathuranow.in and tell us what you plan to build.

Commercial use / licensing: editor@mathuranow.in

About the Rashifal

The Rashifal is AI-assisted and human-reviewed: it is drafted from the day’s verified Panchang and published only after a person has read, edited and approved it. Every Rashifal file carries the note “AI-assisted, human-reviewed. For faith and entertainment.” Please show it with the Rashifal. It is not professional, medical, legal or financial advice.

Terms

Free for non-commercial use with attribution. Fair use applies. Terms may change with 30 days’ notice. The data is provided as it is, with no promise of availability, and we may limit or block access that harms the service. Please see also our Panchang feed usage policy.

Changelog

• 2026-10-14 (v1.1): embed widget (widget.js), OpenAPI 3.1 description, full field reference, public examples repository, licensing contact.
• 2026-10-07 (v1.0): first release: static JSON for the Braj Panchang and the Rashifal, today and dated files, English and Hindi.

Questions or a bug report: editor@mathuranow.in.