GurbaniNow API

Overview

GurbaniNow provides an API specifically designed for developers seeking to integrate Sikh scriptures into their applications and platforms. Established in 2018, the service focuses on delivering Gurbani text, its translations, and transliterations programmatically. The API enables access to the full breadth of the Guru Granth Sahib, providing developers with structured data for building a variety of digital experiences related to Sikhism.

The primary use case for GurbaniNow is to power applications requiring dynamic access to religious texts. This includes mobile applications for daily prayers, websites for scholarly research, or platforms for community engagement. Developers can retrieve hymns (Shabads), verses (Padas), and full compositions in Gurmukhi script, along with English and other language translations. This accessibility supports the creation of tools that help users read, understand, and share Gurbani globally. For instance, a developer might use the API to create an application that displays the Hukamnama (daily command) from the Golden Temple or allows users to search for specific verses by keyword across different translations.

GurbaniNow is particularly well-suited for projects that prioritize accurate and consistent access to Sikh religious content without needing to manage large local databases of scriptures. Its structured API endpoints simplify the process of fetching specific texts, performing searches, and presenting content in various formats. The platform aims to serve both individual developers working on personal projects and larger organizations building commercial applications in the religious content space. The availability of a free tier for personal use makes it accessible for experimentation and small-scale development, while tiered pricing supports scaling for higher request volumes. The API's clear documentation and JavaScript SDK further streamline the integration process, reducing the development overhead for new projects.

While GurbaniNow focuses on API access, other platforms like SikhiToTheMax provide extensive web-based access to Gurbani for direct user interaction, often serving as a primary resource for many adherents. For developers, GurbaniNow provides a direct interface for building custom experiences atop this foundational text. The API's design considers common developer needs, such as efficient data retrieval and clear data formatting, making it a functional choice for those integrating religious texts.

Key features

• Gurbani Text Access: Provides programmatic access to the full text of Sikh scriptures, including the Guru Granth Sahib.
• Multiple Translations: Supports retrieval of Gurbani text alongside various translations, including English.
• Transliteration Support: Offers transliterated versions of Gurmukhi text for easier readability by non-Gurmukhi speakers.
• Search Functionality: Enables searching for specific Shabads, verses, or keywords within the scriptures.
• Structured Data Endpoints: API endpoints are designed to return structured data, facilitating parsing and display in applications.
• Developer-Friendly Documentation: Comprehensive API documentation is available to guide integration and usage.
• JavaScript SDK: Provides a JavaScript SDK to simplify client-side integration and reduce development time.
• Free Personal Use Tier: Offers a free tier for personal projects, allowing developers to experiment and build without initial cost.

Pricing

GurbaniNow offers a free tier for personal use, with paid tiers available for projects requiring higher request volumes. Pricing is structured monthly based on the number of API requests.

Pricing as of 2026-05-28. For the most current pricing details, refer to the GurbaniNow API documentation.

Common integrations

• Mobile Applications (iOS/Android): Integrate Gurbani text and features into native or cross-platform mobile apps for daily prayers or study.
• Web Applications: Power websites that display daily Hukamnama, allow scripture search, or host Gurbani kirtan content.
• Content Management Systems: Use the API to dynamically populate religious content within CMS-driven platforms.
• Educational Platforms: Build tools for learning Gurmukhi, understanding Gurbani meanings, or conducting academic research.
• Smart Displays/IoT Devices: Display Gurbani verses on smart home devices or public information screens.

Alternatives

• SikhiToTheMax: A widely used web-based platform for Gurbani display and search, offering extensive features for direct user interaction.
• GurbaniDB: An open-source project providing a database of Gurbani, potentially offering more direct database access for some use cases.
• SearchGurbani: Another comprehensive online resource for searching and studying Sikh scriptures, including dictionaries and commentaries.

Getting started

To begin using the GurbaniNow API, developers typically register for an API key on the GurbaniNow developer portal. Once an API key is obtained, requests can be made to the various endpoints. The following JavaScript example demonstrates how to fetch a specific Shabad (hymn) by its ID.

async function getShabadById(shabadId) {
  const apiKey = 'YOUR_API_KEY'; // Replace with your actual API key
  const url = `https://api.gurbaninow.com/v2/shabad/${shabadId}?api_key=${apiKey}`;

  try {
    const response = await fetch(url);
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    const data = await response.json();
    console.log('Shabad Data:', data);
    // Example: Accessing the Gurmukhi text of the first verse
    if (data.verses && data.verses.length > 0) {
      console.log('First Verse (Gurmukhi):', data.verses[0].gurmukhi.unicode);
      console.log('First Verse (English Translation):', data.verses[0].translation.english.unicode);
    }
  } catch (error) {
    console.error('Error fetching Shabad:', error);
  }
}

// Example usage: Fetch Shabad with ID 1
getShabadById(1);

This code snippet illustrates a basic fetch request using JavaScript's fetch API. It constructs a URL with the required API key and Shabad ID, then processes the JSON response. The console.log statements show how to access specific fields such as the Gurmukhi text and English translation from the returned data structure. Developers can adapt this pattern to query other endpoints, such as searching for specific words or retrieving daily Hukamnama, as detailed in the GurbaniNow API documentation. Integrating this into a web application might involve displaying the retrieved text within a designated HTML element or processing it further for display in a mobile app. The Fetch API documentation on MDN Web Docs provides broader context for making HTTP requests in JavaScript environments.