find_similar
Retrieves the nearest matching dossier cards for a known entity, enabling peer discovery and clustering by similarity. Pass an entity_id to receive ranked hits with risk and similarity scores.
Instructions
Entities most similar to a given one — the nearest corpus dossier cards ('more like this'), for peer discovery and clustering around a known entity. Pass an entity_id from search_entities. Returns { id, count, hits }, each hit with entity_id, caption, kind, jurisdiction, risk and a similarity score. COVERAGE IS PARTIAL AND SKEWED — it draws on the same embedded slice as semantic_search: 990,055 of a 47,486,969 universe (2.1%), ~99.6% risk-listed and ~97% natural persons, measured 2026-08-11 from the sibling endpoint's own coverage payload. An entity outside that slice returns count: 0 with an empty hits array and HTTP 200 — that is 'not embedded', NOT 'no peers exist', and it is the common case for ordinary companies (verified: BARCLAYS BANK PLC returns zero). Never report an empty result as a finding about the entity. Fall back to semantic_search or search_entities.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | Max hits (default 10). | |
| entity_id | Yes | Entity uuid from search_entities. |