Skip to content
Sri Guru Granth Sahib Ji — Knowledge Base

APIReferenceInsights

Get a concept constellation

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_constellation/

GET
/api/analytics/constellation
curl --request GET \
  --url 'https://example.com/api/analytics/constellation?rahao=1&min_themes=0&ang_min=1&ang_max=1430'

Concept constellation: a theme’s verses, the solo/shared split, every companion theme with its bond, and the Ang strip.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
concept
string

Concept key (omit for the theme list).

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
author
required
string
raag
required
string
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
solo
required
integer
shared
required
integer
clusters
required
Array<object>
object
co
required
string
n
required
integer
verses
required
Array<object>
object
id
required
integer
ang
required
integer
comp_id
required
integer
gurmukhi
required
string
companions
required
Array<object>
object
co
required
string
n
required
integer
ppmi
required
number
jaccard
required
number
shabad_count
required
integer
ang_bins
required
Array<integer>
note
required
string
Examplegenerated
{
  "concept": "example",
  "author": "example",
  "raag": "example",
  "lens": {
    "author": "example",
    "raag": "example",
    "raags": [
      "example"
    ],
    "rahao": true,
    "min_themes": 1,
    "ang_min": 1,
    "ang_max": 1
  },
  "total": 1,
  "solo": 1,
  "shared": 1,
  "clusters": [
    {
      "co": "example",
      "n": 1,
      "verses": [
        {
          "id": 1,
          "ang": 1,
          "comp_id": 1,
          "gurmukhi": "example"
        }
      ]
    }
  ],
  "companions": [
    {
      "co": "example",
      "n": 1,
      "ppmi": 1,
      "jaccard": 1,
      "shabad_count": 1
    }
  ],
  "ang_bins": [
    1
  ],
  "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_constellation/