Rig Veda API reference

This API fetches metadata of the hymns in Rig Veda. The JSON response contains verse-by-verse information on poets, gods, their categories, and the poetic meters.

[
  {
    "mandal": 1,
    "meter": "Gayatri",
    "sukta": 1,
    "sungby": "Madhuchchhanda Vaishwamitra",
    "sungbycategory": "human male",
    "sungfor": "Agni",
    "sungforcategory": "divine male"
  }
]

On this page

Context

An explanation of the various elements in Rig Veda (and this API) is contained in About the Rig Veda API.

Base URL

https://indica-1hwj.onrender.com/rv/v2/meta

The request URL is formed by appending an endpoint to the base URL.

Methods

Only GET calls are supported.

Example request

For the request parameters, see Endpoints.

    curl -X 'GET' \
        'https://indica-1hwj.onrender.com/rv/v2/meta/god/ganga' \
        -H 'accept: application/json'

Example response

For the response parameters, see Response parameters.

[
  	{
  	"mandal": 10,
  	"meter": "Jagati",
  	"sukta": 75,
  	"sungby": "Sindhukshit Praiyamedh",
  	"sungbycategory": "human male",
  	"sungfor": "Ganga",
  	"sungforcategory": "divine female"
  	}
]

Endpoints

All parameters are path parameters. To form the request URL, the endpoint must be appended to the base URL.

request URL = base URL + endpoint

The following endpoints are available.

/book/{mandal}

Returns the metadata of all verses in the specified mandal. For example, /book/4 returns the metadata of all of the verses in the 4th book.

{mandal} is an integer parameter.

Valid values for this parameter are 1 through 10 (because there are only 10 books in Rig Veda).

/meter/{meter}

Returns the metadata of all verses in the specified poetic meter. For example /meter/tup returns the metadata for all verses written in any meter that has tup in its name, such as Anushtup and Trishtup.

{meter} is a string parameter.

/poet/{sungby}

Returns the metadata of all verses by the specified poet. For example, /poet/tra returns the metadata of all verses composed by any poet whose name contains tra, such as Vishwamitra and Vasishth Maitravaruni.

{sungby} is a string parameter.

/poetcategory/{poetcategory}

Returns the metadata of all verses where the poet belongs to the specified category. The following categories are available:

{poetcategory} is a string parameter.

/god/{sungfor}

Returns the metadata of all verses sung for the specified venerated being or object. For example, /god/ni returns all venerated beings or objects whose name contains ni, such as Nirriti (god), Maitravaruni (human), or Sinivali (abstract thing).

{sungfor} is a string parameter.

/god/{sungfor}/{mandal}

Returns the metadata of all verses in a book that are sung for the specified venerated being or object. For example, /god/agni/1 returns the metadata of all verses to Agni in book 1.

{sungfor} is a string parameter and {mandal} an integer parameter.

/godbypoet/{sungfor}/{sungby}

Returns the metadata of all verses sung for the specified venerated being or object (for example Agni or plough) by the specified poet (for example, Vasishth).

{sungfor} and {sungby} are string parameter.

/godcategory/{sungforcategory}

Returns metadata of all verses where a venerated being or object belongs to the specified category. The following categories are available:

{sungforcategory} is a string parameter.

/godcategorybypoetcategory/{sungforcategory}/{sungbycategory}

Returns metadata of all verses where the venerated being or object, and the poet, belong to specified categories. The following categories are available:

{sungforcategory} and {sungbycategory} are string parameters.

Response parameters

All the endpoints return a response in the following format:

{
  "mandal": 0,
  "sukta": 0,
  "meter": "string",
  "sungby": "string",
  "sungbycategory": "string",
  "sungfor": "string",
  "sungforcategory": "string"
}

Here’s a description of these parameter.

Live sandbox

See Rig Veda API: Try it out.