The Vedic APIs

All of the data in the Vedas, presented as JSON or XML objects through APIs

These APIs make available to you two kinds of data: data regarding the gods, poets, and poem meters used in all of the Rig Veda verses, and data regarding the descriptions of almost all of the nouns mentioned in the entire vedic literature.

Here is an example each from the two data sets:

[
    {
        "mandal": 1,
        "sukta": 1,
        "sungby": "Madhuchchhanda Vaishwamitra",
        "sungbycategory": "human male",
        "sungfor": "Agni",
        "sungforcategory": "divine male",
        "meter": "Gayatri"
    }
]
                
[
    {
        "word": "aksh",
        "nagari": "अक्ष",
        "description": "the axle of a chariot",
        "category": "chariot"
    }
]

You can programmatically process the data to make visually appealing or easily consumable information (see Examples).


Making requests to the APIs

The following APIs are available:

  • rv: The Rig Veda API. Returns the gods and poets, their categories, and the meters from all of the Rig Veda verses, together with the mandal and sukta number.
  • vs: The Vedic Society API. Returns the descriptions of all nouns (names, places, animals, things) from the entire vedic literature.

Authentication

Not needed. These are open APIs.

License

These APIs are distributed under the MIT license. This means you are free to use the data any which way you want, so long as you don't hold me liable and you give me an attribution. See The MIT License (MIT).

All content on this website, unless otherwise stated, is distributed under the Creative Commons license. This means the content is dedicated as-is without any liability to the worldwide public domain. See The Creative Commons Zero v1.0 Universal license.

Rate limits

The APIs are hosted on Sheetlabs, which limits the monthly API calls (for free accounts like mine) to 10,000. This limit includes all of us making all of our calls to all of these APIs. Because the APIs need no authentication, I am neither tracking who makes how many calls nor throttling calls on IP-address basis. Just use the APIs in a fair manner, is all that I can say.

If you are using these APIs, do drop me a note please 😊 It'll make my day.


Getting started

For details, see rv API reference documentation and vs API reference documentation.

Endpoints

JSON output is returned by the following endpoints:

  • https://sheetlabs.com/IND/rv, for gods, poets, and meters.
  • https://sheetlabs.com/IND/vs, for descriptions of nouns.

To get output in the XML format, append .xml to the endpoint, like this: https://sheetlabs.com/IND/rv.xml.

Resources

The following resources are available:

  • rv: mandal, sukta, sungby, sungbycategory, sungfor, sungforcategory, and meter
  • vs: word, nagari, description, and category

The mandals and suktas of the rv API are integers; the remaining parameters of the rv API and all of the parameters of the vs API are strings.

Filtering

Optional. All of the parameters can be used for filtering except the nagari parameter of vs API.

You can specify a range for the integers, or partial text for the strings. You can supply more than one parameter in a single call by separating them with an ampersand (&), for example, https://sheetlabs.com/IND/rv?mandal=10&meter=gayatri&sungby=*dra.

Demos

Use these .ipynb files to run interactive demos.

Or, open http://editor.swagger.io/ in a browser, and use these YAML files (rv.yaml and vs.yaml) to get a sense of what kind of data the APIs return.


Release history

1.0

August 2018: Initial offering of the rv and vs APIs

1.1

October 2018:

  • Changed the endpoint of the APIs from https://sheetlabs.com/RV/ to https://sheetlabs.com/IND/
  • Added the following two resources to the rv API: sungbycategoryand sungforcategory