Search candidates
Candidates from a Talent Search by skills, titles and distance from a location.
GET https://cotlet.dev/api/v1/jobdiva/candidates/search
read
Runs the search the way Talent Search does: skills and titles combined with a location and a distance in miles. Returns one page of candidates with location and a short summary, best matches first. Pass page for the next one. Use candidate_id in get_candidate and add_candidates_to_hotlist. Candidates you cannot open in JobDiva are not returned.
Parameters
| Name | Type | Description |
|---|---|---|
| skills string[] | string[] | Skills the resume must show, for example SQL and dbt. |
| titles string[] | string[] | Job titles to look for. |
| location string | string | City or address to measure distance from. |
| within_miles integer | integer | Distance from the location in miles. |
| limit integer | integer | Candidates per page. |
| page integer | integer | Page number, starting at 1. |
Request
curl https://cotlet.dev/api/v1/jobdiva/candidates/search \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("jobdiva", "search_candidates")const result = await cotlet.call('jobdiva', 'search_candidates');cotlet call jobdiva search_candidatesExample response
{
"total": 31,
"candidates": [
{
"candidate_id": 5821904,
"name": "Priya Raman",
"title": "Data Analyst",
"location": "Chicago, IL",
"skills": [
"SQL",
"dbt",
"Looker"
]
},
{
"candidate_id": 5830117,
"name": "Marcus Lee",
"title": "BI Lead",
"location": "Naperville, IL",
"skills": [
"SQL",
"Power BI"
]
},
{
"candidate_id": 5834402,
"name": "Elena Petrova",
"title": "Analytics Engineer",
"location": "Evanston, IL",
"skills": [
"SQL",
"dbt",
"Snowflake"
]
}
],
"page": 1
}