The Vedic APIs

All of the data in the Vedas, presented as JSON dictionaries through APIs

These APIs make available to you two kinds of data:

  • The gods and poets, their categories, and poem meters used in all of the Rig Veda verses
  • The descriptions of all the nouns (except proper nouns) mentioned in 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).

Here's the code for a career advice app made with these APIs. And here's a sample app for a fictional take on the life of a child in vedic times.


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 Heroku, where I have a limit of 500 hours a month. This limit includes all of my apps hosted on Heroku. I am neither tracking who makes how many calls to the APIs nor throttling calls on IP-address basis. My only request is, call these APIs in a fair manner so that I have some hours always available to run my other projects.

If you need to use the APIs rather heavily, please let me know. I'll generate for you a free token, which will give you access to an authenticated hosting service that I also use. This authenticated service has rate limits of 10,000 API calls a month.

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://api-rv.herokuapp.com/rv/v1, for gods, poets, categories, and meters
  • https://api-vs.herokuapp.com/vs/v1, for descriptions of nouns

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

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

You can specify partial text for the strings. Using a single call for filtering on more than one parameter is currently not supported.

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

1.2

December 2020: Changed the endpoint of the APIs to https://api-rv.herokuapp.com/rv/v1 and https://api-vs.herokuapp.com/vs/v1