Fast, powerful JSON API for Gurbani (Guru Granth Sahib Ji, Dasam Granth, and more), powered by the GurbaniNow API. All endpoints return JSON.
Base URL: /api/v2/ (e.g. #replace(cgi.script_name, "api.cfm", "")#api/v2/)
Search
URL: api/v2/search.cfm?query=:query
Search Gurbani by Gurmukhi/Unicode or English. URL-encode the query.
| Parameter | Use |
|---|---|
query | Required. Search text (GurbaniAkhar/Unicode or English per searchtype). |
source | G = Guru Granth Sahib Ji, D = Dasam Granth, B = Bhai Gurdas Vaaran, N = Bhai Nand Lal, A = Amrit Keertan, U = Uggardanti. Default: all. |
searchtype | 0 = First letter start (default), 1 = First letter anywhere, 2 = Full word/line (Gurmukhi), 3 = Full word/line (English), 4–7 = All/any words. |
writer | Writer ID (see WriterID). |
raag | Raag ID (see RaagID). |
ang | Limit to Ang/Page number. |
results | Number of results (default 20, max 100). |
skip | Skip N results (pagination). |
Example: api/v2/search.cfm?query=DDrgj&source=G&searchtype=1
Get Shabad
URL: api/v2/shabad.cfm?id=:id
Example: api/v2/shabad.cfm?id=3589
Get Line
URL: api/v2/line.cfm?id=:id
Example: api/v2/line.cfm?id=1
Get Ang (Page)
URL: api/v2/ang.cfm?page=:page or api/v2/ang.cfm?page=:page&source=:source
source: G (default), D, B, N, A, U.
Example: api/v2/ang.cfm?page=917, api/v2/ang.cfm?page=1&source=D
Hukamnama
Today: api/v2/hukamnama.cfm
Archive: api/v2/hukamnama.cfm?year=yyyy&month=m&day=d (archives from 2002).
Example: api/v2/hukamnama.cfm?year=2017&month=1&day=1
GurbaniAkhar / Unicode converter
URL: api/v2/convert.cfm?type=unicode|akhar&text=:text
type=unicode → GurbaniAkhar to Unicode; type=akhar → Unicode to GurbaniAkhar. URL-encode text.
Example: api/v2/convert.cfm?type=unicode&text=...
This API proxies to api.gurbaninow.com. Data is licensed under CC BY-NC-ND 4.0. Hukamnama updates daily (approx. 9 PM Eastern).
