Search candidates (precision)
precision_search_leadsHigher-precision CoreSignal candidate search using the reasoning endpoint. Interprets the natural language query more carefully than the fast search and returns better-matched candidates plus an explanation of how it interpreted the query. More expensive and rate-limited (~10/hour) — use when match quality matters. Returns the matched candidates as CSV (Name, Title, Company, Location and profile URL) plus a searchId; it does not create a sheet. totalMatches is how many profiles the interpreted query matched before paging: 0 means the criteria as phrased matched nobody, so relax the query rather than repeat it. Spends the workspace's credits and stores the results in SourceGeek so a sheet saved later can carry the full candidate details.
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": {
"query": "<query>"
},
"name": "precision_search_leads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Requested number of candidates to return (1-20). Defaults to 10 when omitted. The data source returns at most 20 results per search. | |
| query | Yes | Natural language search query, e.g. 'VP Engineering at B2B SaaS companies in Amsterdam with 50-500 employees'. |