What it serves
The whole corpus behind the lexicon: 1,286,475 words across 51 kośas and seven padapāṭha texts, with their definition text. Nothing is filtered by tier — the tiers meter how often you may ask, never what you are allowed to see.
Tiers
Signup is open on every tier and your key works immediately. No payment is
taken on this page — there is no checkout wired to the service yet, so a
paid tier is invoiced by hand from
tech@dharmaposhanam.in.
Quick start
One word, with every source that attests it, in the order the project owner has set. No key needed to try it.
curl "https://pk-api-709115207250.us-west1.run.app/v1/word/agniH"
With a key, so your calls are metered against your tier rather than the anonymous per-address limit:
curl -H "X-API-Key: pk_your_key_here" \ "https://pk-api-709115207250.us-west1.run.app/v1/word/Darma"
Words are keyed in SLP1. धर्म is
Darma, कृष्ण is kfzRa —
D is ध and f is ऋ.
Search accepts a prefix:
curl "https://pk-api-709115207250.us-west1.run.app/v1/search?q=agni&mode=prefix&limit=20"
Endpoints
| Method | Path | What it returns |
|---|---|---|
| GET | /v1/word/{slp1} | one entry: every source with its definition text and printed page; padapāṭha occurrences; derivation |
| GET | /v1/search | q, mode = prefix·exact·contains, limit |
| GET | /v1/sources | all 51 kośas with tier, genre and display rank |
| GET | /v1/tiers | the table above, as JSON |
| POST | /v1/key | {"tier","email","organisation"} → a key, shown once |
| POST | /v1/report | report a problem with an entry |
| GET | /v1/docs | the full OpenAPI browser |
Limits and terms
- Without a key the anonymous limit is 90 a minute and 3,000 a day per address. That is far above reading speed; it exists so the corpus cannot be mirrored in bulk, not to ration lookups.
- Your key is shown once. Only a hash is stored, so it cannot be recovered — generate another if you lose it.
- Vaidika loci are provisional. The
citation_warningfield says so on every response that carries them — do not quote those addresses in print until the VedaNidhi vākya table is published. - Cite the printed edition, not this API, when the source is a printed work.
Your usage
Paste a key to see what it has spent today. The key is sent to the API and not stored by this page.