The Bhagavad Gita Application Programming Interface (API) allows a web or mobile developer to use the Bhagavad Gita text in their web or mobile application(s). It is a RESTful API that follows some of the Best Practices for designing a REST API which makes it easy for developers to use and implement.
The current version of the API is v1. We encourage you to explicitly use this version in the url.
All API access is over HTTPS, and accessed from https://bhagavadgita.io/api/v1. All data is sent and received as JSON.
HTTP requests to the BHAGAVAD GITA API are protected with OAUTH2 authentication. To be able to use the API, you need to be a registered BhagavadGita.io user. After signing in, you can register your applications from your Account Dashboard after which you will be issued a Client ID and Client Secret specific to an application that can be used to programatically get the access_token(valid for 300sec).
How to get an access token?
Make a POST request to /auth/oauth/token with these parameters sent in Headers -
client credentials.verse if you just want to access the verses, chapter if you just want to access the chapters and verse chapter if you want access to both.Example -
curl -X POST "https://bhagavadgita.io/auth/oauth/token" -H "accept: application/json" -H "content-type: application/x-www-form-urlencoded" -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials&scope=verse%20chapter"
Then, you can use the received access_token to access any of the endpoints. You can send the access_token as a header or as a query parameter.
Examples -
curl -X GET "https://bhagavadgita.io/api/v1/chapters?access_token=YOUR_ACCESS_TOKEN" -H "accept: application/json"
curl -X GET \
https://bhagavadgita.io/api/v1/chapters \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
We have 2 types of documenatations available for this API, both based on the Open API specification.