Gita API (Telugu & Odia)

Free Bhagavad Gita API with no key: any verse in Telugu, Odia, English or Spanish with word-by-word meanings, translation, commentary and audio. Tested example included.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-21

What is the Gita API (Telugu & Odia)?

This Bhagavad Gita API returns individual verses in Telugu, Odia, English or Spanish with no API key. Each verse comes with the Sanskrit text in the chosen script, word-by-word meanings, a translation, purport commentary and a link to a recitation.

Indian-language coverage of the Gita is patchy in most APIs, which usually offer Sanskrit and English and stop there. This one puts Telugu and Odia first — the languages it was built for — with English and Spanish alongside, and returns the chapter name in the chosen script as well as the verse itself.

What arrives per verse is more than a translation. `synonyms` holds the word-by-word gloss that traditional commentaries use, breaking the Sanskrit into terms with individual meanings; `purport` carries the longer commentary as an array of paragraphs; and `audio_link` points at a recitation of the verse. One thing to get right up front: the language path segment is a three-letter enum — `tel`, `odi`, `eng` or `esp` — and anything else, including the full word `telugu`, returns a 422. The API is a small FastAPI deployment and publishes its own OpenAPI document.

Quick facts

Base URL: https://gita-api.vercel.app
Authentication: No API key and no account.
Rate limit: No published limit. The text never changes — cache it.
Pricing: Free and open source.
CORS: Not enabled — call it from your server
Official docs: Read the docs

How to use the Gita API (Telugu & Odia)

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

1. Fetch a verse in Telugu

GET https://gita-api.vercel.app/tel/verse/1/1

curl

curl 'https://gita-api.vercel.app/tel/verse/1/1'

JavaScript (fetch)

const res = await fetch("https://gita-api.vercel.app/tel/verse/1/1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://gita-api.vercel.app/tel/verse/1/1", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200 (truncated)

{
  "chapter_no": 1,
  "verse_no": 1,
  "language": "telugu",
  "chapter_name": "1. అర్జున విషాద యోగము",
  "verse": "ధృతరాష్ట్ర ఉవాచ ।\nధర్మ క్షేత్రే కురుక్షేత్రే సమవేతా యుయుత్సవః ।\nమామకాః పాండవాశ్చైవ కిమకుర్వత సంజయ ।। 1 ।।",
  "transliteration": "",
  "synonyms": "ధృతరాష్ట్ర ఉవాచ — ధృతరాష్ట్రుడు పలికెను; ధర్మ క్షేత్రే — ధర్మ భూమి; కురు-క్షేత్రే — కురుక్షేత్రం వద్ద; సమవేతాః  — చేరియున్న; యుయుత్సవః — యుద్ధ కాంక్ష తో; మామకాః — నా పుత్రులు; పాండవా — పాండు పుత్రులు; చ — మరియు; ఏవ — నిజముగా; కిం — ఏమి; అకుర్వత — చేసినారు; సంజయ — ఓ సంజయా.",
  "audio_link": "https://www.holy-bhagavad-gita.org/public/audio/001_001.mp3",
  "translation": "ధృతరాష్ట్రుడు పలికెను: ఓ సంజయా, ధర్మభూమి అయిన కురుక్షేత్రం లో కూడియుండి, యుద్ధానికి సన్నద్ధమైన నా పుత్రులు మరియు పాండు పుత్రులు ఏమి చేసారు?",
  "purport": [
    "ధృతరాష్ట్ర మహారాజు పుట్టుకతోనే గుడ్డి వాడే కాక ఆధ్యాత్మిక జ్ఞానం కూడా లోపించిన వాడు. తన పుత్ర వ్యామోహమే అతడిని ధర్మ పథం నుండి తప్పించి, న్యాయపరంగా పాండవులకు చెందిన రాజ్యాన్ని లాక్కునేటట్లు చేసింది. ఆయనకు తన తమ్ముని కుమారులే అయిన పాండు పుత్రులకు తను చేసిన అన్యాయం తెలుసు. తన అంతఃకరణలో తప్పు చేసిన భావన వలన అతడు యుద్ధం యొక్క ఫలితాన్ని గురించి ఆందోళన చెంది, కురుక్షేత్ర యుద్ధ భూమిలో ఏమి జరుగుతోందో అని సంజయుడిని అడిగాడు.",
    "ఈ శ్లోకం లో ధృతరాష్ట్రుడు సంజయుడిని అడిగినది ఏమిటంటే, యుద్ధ భూమి లో చేరి వుండి, తన కొడుకులు మరియు పాండు రాజు కొడుకులు ఏమి చేసారు అని. ఇప్పుడు, యుద్ధ భూమి లో సమావేశమయినది స్పష్టంగా యుద్ధం కోసమే కదా, వారు సహజంగానే యుద్ధమే చేస్తారు. మరి ధృతరాష్ట్రుడికి, వారందరూ ఏమి చేసారని ప్రశ్న అడగాలని ఎందుకు అనిపించింది ?",
    "అతని సందేహాన్ని తను ఉపయోగించిన పదాల ద్వారా తెలుసుకోవచ్చు - \

Parameters

Parameter	Type	Required	Description
`language`	path	Required	Three-letter code: `tel`, `odi`, `eng` or `esp`. Full language names return a 422. `tel`
`chapter_no`	path	Required	Chapter number, 1 to 18. `1`
`verse_no`	path	Required	Verse number within the chapter. `1`
`/{language}/verse/{n}`	path	Optional	Alternative form taking a single serial verse number across the whole text.

Response fields

chapter_no / verse_nointeger: Which verse this is.
languagestring: Full language name echoed back, such as `telugu` — note it differs from the three-letter code you sent.
chapter_namestring: Chapter title in the requested script.
versestring: The verse text itself, in the requested script, with line breaks preserved.
transliterationstring: Romanised reading. Frequently an empty string for the Indian-language editions.
synonymsstring: Word-by-word gloss breaking the Sanskrit into terms with individual meanings, as traditional commentaries do.
translationstring: Prose translation of the whole verse.
purportarray: Commentary paragraphs expanding on the verse.
audio_linkstring: URL of a recitation of the verse, hosted externally.

What you can build with the Gita API (Telugu & Odia)

Build a Gita reading application in Telugu or Odia
Show word-by-word meanings alongside the verse for study
Add recitation audio to a scripture app
Serve a verse-of-the-day in the reader's own language

Common errors and how to fix them

422 Unprocessable Entity

The language segment was a full word rather than the three-letter code.

Fix: Use `tel`, `odi`, `eng` or `esp`. `telugu` is rejected even though it is echoed back in the response.

Empty transliteration

The field is frequently blank for the Indian-language editions.

Fix: Check before rendering and hide the row rather than showing an empty label.

Script renders as boxes

Telugu and Odia need fonts with the right script coverage.

Fix: Specify a font stack with Telugu and Odia support. Most default system fonts lack it.

Cross-origin request blocked

No CORS header is sent.

Fix: Call it from a server rather than from browser JavaScript.

Gita API (Telugu & Odia) — frequently asked questions

Is this Bhagavad Gita API free?

Yes, free with no key or account. It is an open source project deployed on Vercel.

Which languages does it support?

Telugu and Odia, which it was built for, plus English and Spanish. The path segment takes the three-letter codes `tel`, `odi`, `eng` and `esp`.

Why do I get a 422 error?

Because the language segment must be the three-letter code. Sending `telugu` fails validation even though the response echoes that full word back in its `language` field.

What is the synonyms field?

The word-by-word gloss used in traditional commentary — the Sanskrit broken into individual terms with their meanings. It sits between the raw verse and the prose translation.

Tools that pair with this API

Unicode Character Inspector

Inspect any text character by character: Unicode code points, UTF-8 bytes, UTF-16 units, HTML entities, CSS and JS escapes, plus NFC, NFD, NFKC and NFKD forms.

Character Counter

Count characters with and without spaces in real time and check limits for Twitter/X, Instagram captions, meta descriptions and SMS messages.

Text to HTML Converter

Convert plain text to clean HTML: special characters are escaped, paragraphs wrapped in <p> tags, newlines become <br>, and URLs can be auto-linked.

Gita API (Telugu & Odia) is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-21; always check the official documentation before relying on this API in production, as terms and limits can change.