pub.chive.graph.getCommunities

chive.pub

Documentation

Detect communities in the knowledge graph using graph clustering algorithms

main query

Detect communities in the knowledge graph using graph clustering algorithms

Parameters

algorithm string Optional

Community detection algorithm

limit integer Optional

Maximum communities to return

minSize integer Optional

Minimum community size

Output

Encodingapplication/json
algorithm string Required

Algorithm used

Known values: louvain, label-propagation
communities array Required

Detected communities

generatedAt stringdatetime Required

Timestamp when generated

total integer Required

Total communities found

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Community detection algorithm
Maximum communities to return
Minimum community size
View raw schema
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "communities",
        "algorithm",
        "total",
        "generatedAt"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "description": "Total communities found"
        },
        "algorithm": {
          "type": "string",
          "description": "Algorithm used",
          "knownValues": [
            "louvain",
            "label-propagation"
          ]
        },
        "communities": {
          "type": "array",
          "items": {
            "ref": "#communityResult",
            "type": "ref"
          },
          "description": "Detected communities"
        },
        "generatedAt": {
          "type": "string",
          "format": "datetime",
          "description": "Timestamp when generated"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum communities to return"
      },
      "minSize": {
        "type": "integer",
        "default": 2,
        "minimum": 1,
        "description": "Minimum community size"
      },
      "algorithm": {
        "type": "string",
        "default": "louvain",
        "description": "Community detection algorithm",
        "knownValues": [
          "louvain",
          "label-propagation"
        ]
      }
    }
  },
  "description": "Detect communities in the knowledge graph using graph clustering algorithms"
}
communityResult object

Community detection result

Properties

communityId integer Required

Community identifier

members array of string Required

Member URIs

size integer Required

Number of members

View raw schema
{
  "type": "object",
  "required": [
    "communityId",
    "members",
    "size"
  ],
  "properties": {
    "size": {
      "type": "integer",
      "description": "Number of members"
    },
    "members": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Member URIs"
    },
    "communityId": {
      "type": "integer",
      "description": "Community identifier"
    },
    "representativeMembers": {
      "type": "array",
      "items": {
        "ref": "#representativeMember",
        "type": "ref"
      },
      "description": "Representative members with labels"
    }
  },
  "description": "Community detection result"
}
representativeMember object

Representative community member

Properties

label string Required

Member label

uri string Required

Member AT-URI

View raw schema
{
  "type": "object",
  "required": [
    "uri",
    "label"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "description": "Member AT-URI"
    },
    "label": {
      "type": "string",
      "description": "Member label"
    }
  },
  "description": "Representative community member"
}

Lexicon Garden

@