Skip to main content

​
List Entities

Returns knowledge graph entities (nodes) ordered by PageRank. Supports filtering by category, kind, and community ID, plus keyword search across labels and descriptions.

​
Request

GET /api/v1/graph/entities

​
Headers

HeaderRequiredDescription
AuthorizationYesAPI key in Bearer snorbe_... format

​
Query Parameters

ParameterTypeRequiredDefaultDescription
categorystringNo-Filter by exact category match
kindstringNo-Filter by exact kind match
communityIdintegerNo-Filter by community cluster ID
searchstringNo-Keyword search across label and description
metadataKeywordstringNo-Keyword search within metadata JSON
includeOthersEntitiesbooleanNofalseInclude other members’ entities
limitintegerNo30Items per page (1–100)
cursorstringNo-nextCursor from previous page

​
Response

{
  "entities": [
    {
      "id": "clxxx001",
      "label": "Lithium-Ion Battery",
      "category": "Technology",
      "kind": "battery",
      "description": "A type of rechargeable battery",
      "metadata": { "url": { "value": "https://...", "type": "text" } },
      "pagerank": 0.045,
      "communityId": 3,
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-03-20T14:22:00.000Z"
    }
  ],
  "nextCursor": "clxxx031",
  "totalCount": 1296
}

​
Response Fields

FieldTypeDescription
entitiesobject[]Entity array (PageRank descending)
entities[].idstringEntity ID
entities[].labelstringEntity name
entities[].categorystringCategory
entities[].kindstringKind
entities[].descriptionstringDescription
entities[].metadataobject | nullMetadata key-value pairs
entities[].pageranknumberPageRank score
entities[].communityIdnumberCommunity cluster ID
nextCursorstring | nullCursor for next page (null = last page)
totalCountnumberTotal count after filtering

​
Examples

# All entities (PageRank order)
curl "https://app.snorbe.deskrex.ai/api/v1/graph/entities?limit=30" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

# Filter by category
curl "https://app.snorbe.deskrex.ai/api/v1/graph/entities?category=Technology&limit=30" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

# Keyword search
curl "https://app.snorbe.deskrex.ai/api/v1/graph/entities?search=battery&limit=10" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

​
Error Responses

HTTP StatusCodeDescription
401UNAUTHORIZEDInvalid, expired, or missing API key
429TOO_MANY_REQUESTSRate limit exceeded