Skip to content
Sri Guru Granth Sahib Ji — Knowledge Base

APIReferenceInsights

Get the verses two themes share

Updated

Page actions

ChatGPT and Claude are third-party services. The link gives them this page's public address and a short instruction. This site records nothing.

https://docs.gurbanisoul.com/api/reference/operations/analytics_pair/

GET
/api/analytics/pair
curl --request GET \
  --url 'https://example.com/api/analytics/pair?concept=example&alone=1&offset=0&limit=50&rahao=1&min_themes=0&ang_min=1&ang_max=1430'

Verses carrying two themes, grouped by shabad, with the matched words.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
concept
required
string

First theme.

with
string

Second theme (or alone=1).

alone
string
Allowed values: 1 true

The theme’s verses that carry no other theme (instead of with).

offset
integer
0 <= 100000

Verses to skip.

limit
integer
default: 50 >= 1 <= 200

Verses per page.

author
string

Lens: only verses by this author.

raag
string

Lens: only verses in this raag.

raags
string

Lens: only verses in these raags (comma-separated; the “This hour” lens).

rahao
string
Allowed values: 1 true

Lens: refrains (Rahao lines) only.

min_themes
integer
0 <= 8

Lens: verses carrying at least this many themes.

ang_min
integer
default: 1 >= 1 <= 1430

Lens: first Ang.

ang_max
integer
default: 1430 >= 1 <= 1430

Lens: last Ang.

Responses

Section titled “ Responses ”

200

Section titled “200”

OK

Media typeapplication/json
object
concept
required
string
with
required
Any of:
null
alone
required
boolean
lens
required
object
author
required
string
raag
required
string
raags
required
Array
rahao
required
boolean
min_themes
required
integer
ang_min
required
integer
ang_max
required
integer
total
required
integer
offset
required
integer
limit
required
integer
bond
required
Any of:
object
ppmi
required
number
jaccard
required
number
shabad_count
required
integer
shabads
required
Array<object>
object
comp_id
required
integer
ang
required
integer
raag
required
Any of:
null
author
required
string
verses
required
Array<object>
object
id
required
integer
ang
required
integer
is_rahao
required
integer
gurmukhi
required
string
translit
required
string
terms
required
note
required
string
Examplegenerated
{
  "concept": "example",
  "with": "example",
  "alone": true,
  "lens": {
    "author": "example",
    "raag": "example",
    "raags": [
      "example"
    ],
    "rahao": true,
    "min_themes": 1,
    "ang_min": 1,
    "ang_max": 1
  },
  "total": 1,
  "offset": 1,
  "limit": 1,
  "bond": {
    "ppmi": 1,
    "jaccard": 1,
    "shabad_count": 1
  },
  "shabads": [
    {
      "comp_id": 1,
      "ang": 1,
      "raag": "example",
      "author": "example",
      "verses": [
        {
          "id": 1,
          "ang": 1,
          "is_rahao": 1,
          "gurmukhi": "example",
          "translit": "example",
          "terms": "example"
        }
      ]
    }
  ],
  "note": "example"
}

400

Section titled “400”

Invalid request (bad or out-of-range parameter).

Media typeapplication/json
object
error
required
string
Examplegenerated
{
  "error": "example"
}

500

Section titled “500”

Internal error (generic body; details are logged, never returned).

Media typeapplication/json
object
error
required
string
Examplegenerated
{
  "error": "example"
}

Sri Guru Granth Sahib Ji — Knowledge Base wiki. Generated from commit c3d9360. Updated 24 October 2026. This copy may be out of date; the page is at https://docs.gurbanisoul.com/api/reference/operations/analytics_pair/