Search candidates
Candidates matching keywords in name, occupation, company, resume, work history and attachments.
GET https://cotlet.dev/api/v1/bullhorn/candidates/search
read
Searches the way the candidate list keyword search does: Candidate Name, Occupation, Current Company, Resume, Work History and File Attachments. Custom fields are not searched. Several keywords combine with and by default; match any uses or, and exclude_keywords removes candidates that contain them. Returns one page of candidates; pass next_cursor back as cursor for more. Use candidate_id in get_candidate and add_note.
Parameters
| Name | Type | Description |
|---|---|---|
| keywords string[] required | string[] | Words or phrases to look for. |
| match enum | enum | all (And, default) or any (Or). |
| exclude_keywords string[] | string[] | Candidates containing any of these are left out. |
| limit integer | integer | Candidates per page. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/bullhorn/candidates/search?keywords=keywords" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bullhorn", "search_candidates", {"keywords":["keywords"]})const result = await cotlet.call('bullhorn', 'search_candidates', {"keywords":["keywords"]});cotlet call bullhorn search_candidates --data '{"keywords":["keywords"]}'Example response
{
"total": 31,
"candidates": [
{
"candidate_id": 4821907,
"name": "Priya Raman",
"occupation": "Data Analyst",
"company": "Brightpath Retail",
"status": "Active",
"submission_count": 4
},
{
"candidate_id": 4830112,
"name": "Marcus Lee",
"occupation": "BI Lead",
"company": "Harbor Logistics",
"status": "Active",
"submission_count": 1
}
],
"next_cursor": null
}