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
Default
50Range
1 <= value <= 200entity_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].
Default
falseResponse Body
application/json
application/json
curl -X GET "http://127.0.0.1:14242/entities"null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}