vedabase.io APIvedabase.io ↗
Access Bhagavad-gita, Srimad-Bhagavatam, and Caitanya-caritamrta verses, purports, transcripts, and letters via the Vedabase.io API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e83a450a-a65b-4a73-98d1-e853df9bb882/get_library' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the full list of books available in the Vedabase library.
No input parameters required.
{
"type": "object",
"fields": {
"books": "array of book objects with title, slug, and url"
},
"sample": {
"data": {
"books": [
{
"url": "https://vedabase.io/en/library/bg/",
"slug": "bg",
"title": "Bhagavad-gītā As It Is"
}
]
},
"status": "success"
}
}About the vedabase.io API
The Vedabase.io API gives programmatic access to the full Vedabase library across 14 endpoints, covering Sanskrit verses in Devanagari and IAST transliteration, word-for-word synonym indexes, English translations, and Prabhupada's purports. The get_verse endpoint returns six structured fields per verse — devanagari, verse_text, synonyms, translation, purport, and title — for the three major canonical texts. Separate endpoints cover transcripts and letters with pagination and filtering.
Verse and Book Navigation
The API is structured around three navigational tiers. get_library returns all available books as slugs and URLs. get_book takes a book_slug (bg, sb, or cc) and returns the table of contents — chapters for Bhagavad-gita, cantos for Srimad-Bhagavatam, or lilas for Caitanya-caritamrta. get_chapter then lists all verses in a given chapter, accepting canto_slug for SB and lila_slug (adi, madhya, antya) for CC.
Verse Content
get_verse is the core endpoint. It returns the devanagari script text, verse_text in IAST transliteration, a synonyms string with word-for-word meanings, an English translation, and purport as an array of paragraph strings. Dedicated shorthand endpoints — get_bhagavad_gita_verse, get_srimad_bhagavatam_verse, and get_caitanya_caritamrta_verse — accept the same fields but omit the book_slug parameter, reducing the number of required inputs for single-text applications.
Search and Indexes
search runs full-text queries across the entire library with optional filters for type (Book, Transcript, Letter) and text_type (Text, Purport), returning paginated results with title, url, and snippet. search_synonyms queries the Word-for-Word Index by Sanskrit word or English translation, returning word, definition, and reference per result. search_verse_index matches IAST transliterated text with match_type options of contains, exact-word, or starts.
Transcripts and Letters
get_transcripts returns paginated listings of Prabhupada's lectures filterable by type, year, and location. get_transcript fetches the full text of a single talk as an array of paragraph strings. get_letters similarly lists letters filterable by year, location, and recipient, with get_letter retrieving full letter content by slug.
- Build a Bhagavad-gita study app that displays Devanagari, transliteration, and purport side by side using
get_bhagavad_gita_verse - Create a Sanskrit vocabulary tool by querying the Word-for-Word Index via
search_synonymswith Sanskrit or English terms - Generate a daily verse digest by iterating chapters and verses from
get_bookandget_verse - Index all of Prabhupada's letters by recipient and year using
get_lettersfilters for archival or research purposes - Build a full-text search interface over the entire Vedabase corpus using the
searchendpoint withtypeandtext_typefilters - Locate verses from partial IAST transliterated text using
search_verse_indexwithstartsorcontainsmatch types - Compile transcripts of lectures from a specific city and year using
get_transcriptslocation and year filters
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Vedabase.io have an official developer API?+
What does `get_verse` return, and how does it differ from the book-specific shorthand endpoints?+
get_verse returns six fields: devanagari, verse_text (IAST), synonyms, translation, purport (array of paragraphs), and title. It requires book_slug plus either canto_slug (for SB) or lila_slug (for CC). The shorthand endpoints — get_bhagavad_gita_verse, get_srimad_bhagavatam_verse, and get_caitanya_caritamrta_verse — return identical fields but omit book_slug since it is implied.Does the API cover books other than Bhagavad-gita, Srimad-Bhagavatam, and Caitanya-caritamrta?+
get_library endpoint lists all books available in the Vedabase library, and get_book accepts any valid slug from that list. The dedicated verse endpoints and their slug parameters are documented for BG, SB, and CC specifically. If the library contains additional titles, you can fork this API on Parse and revise it to add explicit verse endpoints for those books.Can I filter transcripts by topic or scripture reference?+
get_transcripts supports filtering by type (e.g., Conversation, Walk), year, and location. Filtering by topic keyword or scripture reference is not currently exposed as a parameter. You can fork this API on Parse and revise it to add topic-based filtering if the source supports it.How does pagination work across endpoints that return lists?+
search, search_synonyms, search_verse_index, get_transcripts, and get_letters endpoints all accept an integer page parameter. Responses echo back the current page value alongside the results array. There is no total_pages or total_results field in the current response shape, so iterating requires checking whether a page returns an empty results array.