Geeta API Guide

The Geeta API provides access to chapters and shlokas from the Bhagavad Gita in Hindi. This guide explains how to use the API endpoints to retrieve the chapter details and individual shlokas.

Features

API Endpoints

1. List All Chapters

Returns a list of all chapters in the Bhagavad Gita, including the chapter name, its meaning, and a brief summary in Hindi.

Request:

GET /adhyay/

Response Example:


          
[{
  "chapter": 1,
  "name": "अर्जुन विषाद योग",
  "meaning": "अर्जुन के विषाद का योग",
  "summary": "इस अध्याय में अर्जुन युद्ध के मैदान में शोक और भ्रम से घिर जाते हैं...",
  "hindiNumber": "१"
},
{
  "chapter": 2,
  "name": "सांख्ययोग",
  "meaning": "गीता का सार",
  "summary": "भगवद गीता का दूसरा अध्याय सांख्य योग है। यह अध्याय भगवद गीता का...",
  "hindiNumber": "२"
}]

2. Get Details of a Specific Chapter

Returns the details of the specified chapter in Hindi.

Request:

GET /adhyay/{chapter_number}

Response Example:


{
  "chapter": 1,
  "name": "अर्जुन विषाद योग",
  "meaning": "अर्जुन के विषाद का योग",
  "summary": "इस अध्याय में अर्जुन युद्ध के मैदान में शोक और भ्रम से घिर जाते हैं...",
  "hindiNumber": "१"
}

3. List All Shlokas from a Chapter

Returns a list of all shlokas from the specified chapter in Hindi.

Request:

GET /shlok/{chapter_number}

Response Example:


[{
  "text": "धृतराष्ट्र उवाच |\nधर्मक्षेत्रे कुरुक्षेत्रे समवेता युयुत्सवः...",
  "meaning": "धृतराष्ट्र बोले- हे संजय! धर्मभूमि कुरुक्षेत्र में...",
  "chapter": 1,
  "shlokNo": "१",
  "number": 1
},
{
  "text": "सञ्जय उवाच ।\nदृष्ट्वा तु पाण्डवानीकं व्यूढं दुर्योधनस्तदा...",
  "meaning": "संजय बोले- उस समय राजा दुर्योधन ने...",
  "chapter": 1,
  "shlokNo": "२",
  "number": 2
}]

4. Get a Specific Shloka by Chapter and Verse

Returns a specific shloka and its meaning in Hindi.

Request:

GET /shlok/{chapter_number}/{verse_number}

Response Example:


{
  "text": "धृतराष्ट्र उवाच |\nधर्मक्षेत्रे कुरुक्षेत्रे समवेता युयुत्सवः...",
  "meaning": "धृतराष्ट्र बोले- हे संजय! धर्मभूमि कुरुक्षेत्र में...",
  "chapter": 1,
  "shlokNo": "१",
  "number": 1
}