API ReferenceEntities
List Entities
List entities with optional filtering.
When include_stats=true returns
[{"entity": EntityNode, "mention_count": int}, ...] sorted by
mention_count DESC. Otherwise returns the legacy List[EntityNode]
sorted by created_at DESC, preserving backwards compatibility for
older callers (Tauri commands, MCP tools).
Query Parameters
limit?Limit
entity_type?string|null
include_stats?Include Stats
Return entities sorted by mention_count DESC and include the count alongside each entity. Powers the Library Entities tab's signal-first ranking. When false (default), the response shape is the legacy List[EntityNode].
Response Body
application/json
application/json
curl -X GET "https://example.com/entities"null{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}