Search talents - Kalent API

GET

v0.1

talents

Search talents

curl --request GET \
  --url https://app.kalent.ai/api/v0.1/search/talents \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://app.kalent.ai/api/v0.1/search/talents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.kalent.ai/api/v0.1/search/talents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.kalent.ai/api/v0.1/search/talents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.kalent.ai/api/v0.1/search/talents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

This is a legacy endpoint. We recommend migrating to v1 Search Talents which supports 17 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

string[]

One or more job titles to search for. Repeat the parameter for multiple values.

?jobTitles=Software Engineer&jobTitles=Product Designer

string[]

One or more city names. Repeat the parameter for multiple values.

?cities=Paris&cities=Lyon

string[]

Free-text keywords to match against profiles. Repeat the parameter for multiple values.

?keywords=React&keywords=TypeScript

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..."
  }
}

{
  "success": false,
  "error": "Invalid query parameters",
  "details": { ... }
}

{
  "success": false,
  "error": "Invalid API key"
}

{
  "success": false,
  "error": "An error occurred during search talents",
  "debugTrackingCode": "V1StGXR8_Z5jdHi6B-myT"
}

AuthenticationAuthenticate your requests with an API key.

Search talents

curl --request GET \
  --url https://app.kalent.ai/api/v0.1/search/talents \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://app.kalent.ai/api/v0.1/search/talents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.kalent.ai/api/v0.1/search/talents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.kalent.ai/api/v0.1/search/talents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.kalent.ai/api/v0.1/search/talents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

First time? Set up Authentication

​Query parameters

​Example request

​Response

Query parameters

Example request

Response