Skip to main content
GET
/
v0.1
/
search
/
talents
Search talents
curl --request GET \
  --url https://app.kalent.ai/api/v0.1/search/talents \
  --header 'x-api-key: <api-key>'
This is a legacy endpoint. We recommend migrating to v1 Search Talents which supports 16 filter types, required/optional modifiers, and ranked results.

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.
 Search the Kalent talent database using job titles, cities, keywords, and contract type as query parameters. Returns up to 5 matching profiles per request.

​
Query parameters

​
jobTitles
string[]
One or more job titles to search for. Repeat the parameter for multiple values.
?jobTitles=Software Engineer&jobTitles=Product Designer
​
cities
string[]
One or more city names. Repeat the parameter for multiple values.
?cities=Paris&cities=Lyon
​
keywords
string[]
Free-text keywords to match against profiles. Repeat the parameter for multiple values.
?keywords=React&keywords=TypeScript
​
contractType
string
Filter by contract type. Only accepted value: Freelance.

​
Example request

curl -G "https://app.kalent.ai/api/v0.1/search/talents" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "jobTitles=Software Engineer" \
  --data-urlencode "cities=Paris" \
  --data-urlencode "keywords=React"

​
Response

{
  "success": true,
  "data": {
    "talents": [
      {
        "id": "clx...",
        "firstName": "Marie",
        "lastName": "D.",
        "headline": "Senior Software Engineer",
        "linkedinUrl": "https://linkedin.com/in/marie-d"
      }
    ],
    "estimationCount": 342,
    "searchTransactionId": "clx..."
  }
}