Find similar candidates
similarCandidatesGiven one candidate your company has already been shown, return other candidates whose profiles are closest to theirs, ranked by similarity. Use it when someone likes a specific profile and wants more of the same, and after requestIntro to keep the shortlist moving. Chain it: run it again on a result to walk further from the original person. Similarity is computed from the whole profile (role, skills, experience and domain), not from filters, so this takes no search criteria; use searchCandidates when the ask is a requirement rather than a resemblance. Results stay within a band around the starting candidate's years of experience. Each result carries a similarity from 0 to 1 for your own screening: a low number means the open pool had nobody close, so say that instead of presenting a weak match as similar, and never show the number to the user. The same exclusions as searchCandidates apply, so people already shown to your company, your own employees, and people who work at Clera never come back, and the starting candidate is never in their own results.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"talentId": "<talentId>"
},
"name": "similarCandidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1). | |
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| per_page | No | Results to return, up to 10. They are displayed as cards. | |
| talentId | Yes | The candidate to match against, as returned by searchCandidates, listRecommendedCandidates or listPendingIntroRequests. Must be someone Clera has already shown your company. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | ||
| orgId | Yes | ||
| counts | No | ||
| talents | Yes | ||
| semantic | No | ||
| conflicts | No | ||
| openRoles | Yes | The company's open roles, for picking which role an intro request targets. | |
| pagination | Yes | ||
| filterParams | Yes |