# Vedabase — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Vedabase provides 14 callable API endpoints through the Parse marketplace.

**Category:** Education | **Website:** [vedabase.io/](https://vedabase.io/) | **Docs:** [parse.bot/marketplace/4074a3db-6c91-40e5-a355-18b76b835292/vedabase-io-api](https://parse.bot/marketplace/4074a3db-6c91-40e5-a355-18b76b835292/vedabase-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bhagavad_gita_verse

Returns verse details specifically for Bhagavad-gita. Shorthand for get_verse with book_slug='bg'. Returns Devanagari text, transliteration, synonyms, translation, and purport.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chapter_slug` | string | Yes | Chapter number (1-18). |
| `verse_slug` | string | Yes | Verse number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_bhagavad_gita_verse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chapter_slug":"<string>","verse_slug":"<string>"}'
```

### get_book

Returns the table of contents (chapters, cantos, or lilas) for a specific book identified by its slug. For Bhagavad-gita ('bg') returns chapters, for Srimad-Bhagavatam ('sb') returns cantos, and for Caitanya-caritamrta ('cc') returns lilas.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_slug` | string | Yes | The slug of the book (e.g., 'bg' for Bhagavad-gita, 'sb' for Srimad-Bhagavatam, 'cc' for Caitanya-caritamrta, 'noi' for Nectar of Instruction). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_book \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_slug":"<string>"}'
```

### get_caitanya_caritamrta_verse

Returns verse details specifically for Caitanya-caritamrta. Shorthand for get_verse with book_slug='cc'. Returns transliteration, synonyms, translation, and purport.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `chapter_slug` | string | Yes | Chapter number. |
| `lila_slug` | string | Yes | Lila slug. Accepted values: adi, madhya, antya. |
| `verse_slug` | string | Yes | Verse number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_caitanya_caritamrta_verse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chapter_slug":"<string>","lila_slug":"<string>","verse_slug":"<string>"}'
```

### get_chapter

Returns the list of verses in a specific chapter. For Srimad-Bhagavatam, provide canto_slug. For Caitanya-caritamrta, provide lila_slug. Each verse includes title, slug, and URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_slug` | string | Yes | Book slug (e.g., 'bg', 'sb', 'cc'). |
| `canto_slug` | string | No | Canto number (required for Srimad-Bhagavatam, book_slug='sb'). |
| `chapter_slug` | string | Yes | Chapter number or slug. |
| `lila_slug` | string | No | Lila slug (required for Caitanya-caritamrta, book_slug='cc'). Accepted values: adi, madhya, antya. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_chapter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_slug":"<string>","canto_slug":"<string>","chapter_slug":"<string>","lila_slug":"<string>"}'
```

### get_letter

Returns the full text content of a specific letter identified by its slug. Content is returned as an array of paragraph strings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter_slug` | string | Yes | Letter slug (from get_letters results, e.g., 'letter-to-mahatma-gandhi'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter_slug":"<string>"}'
```

### get_letters

Returns a paginated list of letters written by Srila Prabhupada. Supports filtering by year, location, and recipient.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Filter by location. |
| `page` | integer | No | Page number for pagination. |
| `recipient` | string | No | Filter by recipient name. |
| `year` | string | No | Filter by year (e.g., '1968'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_letters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","recipient":"<string>","year":"<string>"}'
```

### get_library

Returns the full list of books available in the Vedabase library. Each book includes a title, slug identifier, and URL. Use the slug to drill into a book's table of contents via get_book.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_library \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_srimad_bhagavatam_verse

Returns verse details specifically for Srimad-Bhagavatam. Shorthand for get_verse with book_slug='sb'. Returns Devanagari text, transliteration, synonyms, translation, and purport.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `canto_slug` | string | Yes | Canto number (1-12). |
| `chapter_slug` | string | Yes | Chapter number. |
| `verse_slug` | string | Yes | Verse number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_srimad_bhagavatam_verse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"canto_slug":"<string>","chapter_slug":"<string>","verse_slug":"<string>"}'
```

### get_transcript

Returns the full text content of a specific transcript identified by its slug. Content is returned as an array of paragraph strings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `transcript_slug` | string | Yes | Transcript slug (from get_transcripts results, e.g., '660219bg-new-york'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_transcript \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transcript_slug":"<string>"}'
```

### get_transcripts

Returns a paginated list of transcripts of Srila Prabhupada's lectures and talks. Supports filtering by type, year, and location.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Filter by location (e.g., 'New York'). |
| `page` | integer | No | Page number for pagination. |
| `type` | string | No | Filter by type (e.g., Conversation, Walk). |
| `year` | string | No | Filter by year (e.g., '1966'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_transcripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","type":"<string>","year":"<string>"}'
```

### get_verse

Returns full content of a single verse including Devanagari text, IAST transliteration, word-for-word synonyms, English translation, and purport paragraphs. For Srimad-Bhagavatam provide canto_slug, for Caitanya-caritamrta provide lila_slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `book_slug` | string | Yes | Book slug (e.g., 'bg', 'sb', 'cc'). |
| `canto_slug` | string | No | Canto number (required for sb). |
| `chapter_slug` | string | Yes | Chapter number. |
| `lila_slug` | string | No | Lila slug (required for cc). Accepted values: adi, madhya, antya. |
| `verse_slug` | string | Yes | Verse number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/get_verse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"book_slug":"<string>","canto_slug":"<string>","chapter_slug":"<string>","lila_slug":"<string>","verse_slug":"<string>"}'
```

### search

Full-text search across the entire Vedabase library. Returns paginated results with title, URL, and text snippet. Results include books, transcripts, and letters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword or phrase. |
| `text_type` | string | No | Filter by text type (e.g., Text, Purport). |
| `type` | string | No | Filter by content type (e.g., Book, Transcript, Letter). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","text_type":"<string>","type":"<string>"}'
```

### search_synonyms

Search the Word-for-Word Index for Sanskrit words and their meanings. Returns matching words with their definitions and verse references. At least one of word or translation should be provided for meaningful results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `translation` | string | No | English translation to search for. |
| `word` | string | No | Sanskrit word to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/search_synonyms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","translation":"<string>","word":"<string>"}'
```

### search_verse_index

Search for verses by their IAST transliterated text. Returns matching verse references with text snippets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_type` | string | No | Match type. Accepted values: contains, exact-word, starts. |
| `page` | integer | No | Page number for pagination. |
| `text` | string | Yes | IAST transliterated text to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vedabase-io-api-4074a3db/search_verse_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_type":"<string>","page":"<integer>","text":"<string>"}'
```