Find matching candidates
Candidates that match a job by its description and location, like Find Matching Candidates.
GET https://cotlet.dev/api/v1/bullhorn/jobs/{job_id}/matching-candidates/find
read
Runs the app's Find Matching Candidates search for one job. When the description has more than 250 words, Bullhorn takes up to 10 keywords from it and uses the job zip code with a radius of 20 miles. Pass keywords or radius_miles to change that. Returns one page of candidates, best matches first as Bullhorn orders them.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id integer required | integer | Job ID from get_job or the job record URL. |
| keywords string[] | string[] | Replaces the keywords taken from the job description. |
| radius_miles integer | integer | Search radius around the job zip code. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/bullhorn/jobs/1/matching-candidates/find \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bullhorn", "find_matching_candidates", {"job_id":1})const result = await cotlet.call('bullhorn', 'find_matching_candidates', {"job_id":1});cotlet call bullhorn find_matching_candidates --data '{"job_id":1}'Example response
{
"total": 31,
"candidates": [
{
"candidate_id": 4821907,
"name": "Priya Raman",
"occupation": "Data Analyst",
"company": "Brightpath Retail",
"status": "Active",
"submission_count": 4
}
],
"next_cursor": "2"
}