The festivals-by-date API helps you find the festivals and other important events observed on a specific date for a given location. It takes the date, time, latitude, longitude, and timezone as input and returns the festivals and events applicable to that location and day.
The response includes the festival or event names along with the total number of results found for the requested date. This makes the API useful for applications that need to display daily festival information, build Panchang or calendar features, or show upcoming cultural and religious events based on the user's location.
Accept-Language: enGuide:These languages are supported by this API. You can use them by passing Accept-Language header with a value of the language code.
{
"date": "30-8-2026",
"count": 3,
"festivals": [
"2nd Chaturmasa Day 6",
"2nd Chaturmasa Day 7",
"Kajari Teej"
],
"msg": "3 festival/events found for this date"
}var api = 'festivals-by-date';
var userId = '<Your User Id>';
var apiKey = '<Your Api Key>';
var language = '<Your Language>' // By default it is set to en
var data = {
day: 6,
month: 1,
year: 2000,
hour: 7,
min: 45,
lat: 19.132,
lon: 72.342,
tzone: 5.5,
};
var auth = "Basic " + new Buffer(userId + ":" + apiKey).toString("base64");
var request = $.ajax({
url: "https://json.astrologyapi.com/v1/"+api,
method: "POST",
dataType:'json',
headers: {
"authorization": auth,
"Content-Type":'application/json',
"Accept-Language": language
},
data:JSON.stringify(data)
});
request.then( function(resp){
console.log(resp);
}, function(err){
console.log(err);
});