Skip to main content
POST
/
v1
/
recruiter
/
candidates
Get Candidates
curl --request POST \
  --url https://api.linkupapi.com/v1/recruiter/candidates \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "job_id": "<string>",
  "total_results": 123,
  "start_page": 123,
  "end_page": 123,
  "start": "<string>",
  "sortType": "<string>",
  "sortOrder": "<string>",
  "ratings": "<string>",
  "location": "<string>",
  "yearsOfExperience": "<string>",
  "country": "<string>",
  "login_token": "<string>"
}
'
import requests

url = "https://api.linkupapi.com/v1/recruiter/candidates"

payload = {
"job_id": "<string>",
"total_results": 123,
"start_page": 123,
"end_page": 123,
"start": "<string>",
"sortType": "<string>",
"sortOrder": "<string>",
"ratings": "<string>",
"location": "<string>",
"yearsOfExperience": "<string>",
"country": "<string>",
"login_token": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
job_id: '<string>',
total_results: 123,
start_page: 123,
end_page: 123,
start: '<string>',
sortType: '<string>',
sortOrder: '<string>',
ratings: '<string>',
location: '<string>',
yearsOfExperience: '<string>',
country: '<string>',
login_token: '<string>'
})
};

fetch('https://api.linkupapi.com/v1/recruiter/candidates', 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://api.linkupapi.com/v1/recruiter/candidates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'job_id' => '<string>',
'total_results' => 123,
'start_page' => 123,
'end_page' => 123,
'start' => '<string>',
'sortType' => '<string>',
'sortOrder' => '<string>',
'ratings' => '<string>',
'location' => '<string>',
'yearsOfExperience' => '<string>',
'country' => '<string>',
'login_token' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-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"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.linkupapi.com/v1/recruiter/candidates"

payload := strings.NewReader("{\n \"job_id\": \"<string>\",\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"start\": \"<string>\",\n \"sortType\": \"<string>\",\n \"sortOrder\": \"<string>\",\n \"ratings\": \"<string>\",\n \"location\": \"<string>\",\n \"yearsOfExperience\": \"<string>\",\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/recruiter/candidates")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"job_id\": \"<string>\",\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"start\": \"<string>\",\n \"sortType\": \"<string>\",\n \"sortOrder\": \"<string>\",\n \"ratings\": \"<string>\",\n \"location\": \"<string>\",\n \"yearsOfExperience\": \"<string>\",\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v1/recruiter/candidates")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"job_id\": \"<string>\",\n \"total_results\": 123,\n \"start_page\": 123,\n \"end_page\": 123,\n \"start\": \"<string>\",\n \"sortType\": \"<string>\",\n \"sortOrder\": \"<string>\",\n \"ratings\": \"<string>\",\n \"location\": \"<string>\",\n \"yearsOfExperience\": \"<string>\",\n \"country\": \"<string>\",\n \"login_token\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "status": "success",
  "data": {
    "total_results": 1,
    "candidates": [
      {
        "application_id": "22985735624",
        "rating": "GOOD_FIT",
        "is_top_choice": true,
        "top_choice_message": "Hello,\nI'm very excited about this opportunity and believe my background in digital marketing would be a perfect fit. Please find my resume attached.\nBest regards,\nSarah",
        "first_name": "Sarah",
        "last_name": "Johnson",
        "full_name": "Sarah Johnson",
        "headline": "Digital Marketing Director | SEO | Content Strategy | E-commerce",
        "public_identifier": "sarahjohnsondigital",
        "profile_url": "https://www.linkedin.com/in/sarahjohnsondigital",
        "location": "London, United Kingdom",
        "experiences": [
          {
            "title": "Digital Marketing Director",
            "company": "TechGrowth Solutions",
            "company_url": "https://www.linkedin.com/company/techgrowth-solutions/",
            "date_range": "5/2022 - Present",
            "description": "Leading a team of 12 marketing specialists across SEO, content, and paid acquisition channels. Developed and executed comprehensive marketing strategies that increased organic traffic by 78% and improved conversion rates by 34% within 18 months."
          },
          {
            "title": "Senior Marketing Manager",
            "company": "E-Commerce Innovators",
            "company_url": "https://www.linkedin.com/company/ecommerce-innovators/",
            "date_range": "3/2019 - 5/2022",
            "description": "Managed digital marketing initiatives for B2B SaaS platform. Implemented data-driven marketing strategies that generated 12M in pipeline and contributed to 25% YoY revenue growth."
          }
        ],
        "education": [
          {
            "school": "University of Manchester",
            "school_url": "https://www.linkedin.com/school/university-of-manchester/",
            "degree": "Master's degree, Digital Marketing",
            "field": "Marketing",
            "years": "2016 - 2018"
          },
          {
            "school": "King's College London",
            "school_url": "https://www.linkedin.com/school/kings-college-london/",
            "degree": "Bachelor's degree, Business Administration",
            "field": "Marketing and Communications",
            "years": "2012 - 2016"
          }
        ],
        "responses": {
          "Do you have experience with SEO and SEM strategies?": "Yes, I have 8+ years of experience developing and implementing SEO/SEM strategies for e-commerce and SaaS companies. My recent campaign increased organic traffic by 78% year-over-year.",
          "Are you willing to relocate?": "Yes, I'm open to relocation opportunities."
        },
        "application_date": "2025-04-15 10:27:39",
        "contact_email": "[email protected]",
        "contact_phone": "+44 7700 900123"
      }
    ]
  }
  "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 10,
      "pages_fetched": 1
    }
}
Retrieve detailed information about candidates who have applied to your LinkedIn job posting, including their profiles, work experience, education, contact information, and application responses.
This endpoint costs 1 credit per result.

Header Parameters

x-api-key
string
required
Your API key

Body Parameters

job_id
string
required
LinkedIn job posting ID (e.g., “4178681649”, you can get it with the /recruiter/posts endpoint)
total_results
integer
default:"10"
Number of profiles to retrieve
start_page
integer
First page to fetch when using pagination mode (default: 1)
end_page
integer
Last page to fetch when using pagination mode (default: same as start_page)
start
string
default:"0"
Starting position for pagination
sortType
string
default:"RELEVANCE"
Sorting method. Options: RELEVANCE, APPLIED_DATE
sortOrder
string
default:"DESCENDING"
Sorting order. Options: ASCENDING, DESCENDING
ratings
string
default:"GOOD_FIT,MAYBE,UNRATED"
Candidate ratings to include, comma-separated (e.g, “GOOD_FIT,MAYBE,UNRATED,NOT_A_FIT”)
location
string
Filter candidates by location (e.g., “Paris”)
yearsOfExperience
string
Filter by years of experience, comma-separated (e.g., “THREE_TO_FIVE_YEARS,SIX_TO_TEN_YEARS”)
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
login_token
string
required
LinkedIn authentication cookie () obtained from the login/verify process

Response

status
string
Request status (success/error)
data
object
Response data container
data.total_results
integer
Total number of candidates retrieved
data.candidates
array
List of candidate profiles
data.candidates[].application_id
string
Unique ID of the application
data.candidates[].rating
string
Recruiter’s rating of the candidate (GOOD_FIT, MAYBE, UNRATED, NOT_A_FIT)
data.candidates[].is_top_choice
boolean
Whether the candidate is marked as a top choice
data.candidates[].top_choice_message
string
Message from candidate if marked as top choice
data.candidates[].first_name
string
Candidate’s first name
data.candidates[].last_name
string
Candidate’s last name
data.candidates[].full_name
string
Candidate’s full name
data.candidates[].headline
string
Candidate’s LinkedIn headline
data.candidates[].public_identifier
string
Candidate’s LinkedIn URL identifier
data.candidates[].profile_url
string
Complete LinkedIn profile URL
data.candidates[].linkedin_id
string
Candidate’s LinkedIn internal ID
data.candidates[].location
string
Candidate’s location
data.candidates[].experiences
array
List of candidate’s work experiences
data.candidates[].experiences[].title
string
Job title
data.candidates[].experiences[].company
string
Company name
data.candidates[].experiences[].company_url
string
LinkedIn URL of the company
data.candidates[].experiences[].date_range
string
Employment period
data.candidates[].experiences[].description
string
Job description
data.candidates[].education
array
List of candidate’s education history
data.candidates[].education[].school
string
School name
data.candidates[].education[].school_url
string
LinkedIn URL of the school/university
data.candidates[].education[].degree
string
Degree obtained
data.candidates[].education[].field
string
Field of study
data.candidates[].education[].years
string
Period of study
data.candidates[].responses
object
Candidate’s answers to job application questions
data.candidates[].application_date
string
Date and time when the application was submitted
data.candidates[].contact_email
string
Candidate’s email address
data.candidates[].contact_phone
string
Candidate’s phone number
{
  "status": "success",
  "data": {
    "total_results": 1,
    "candidates": [
      {
        "application_id": "22985735624",
        "rating": "GOOD_FIT",
        "is_top_choice": true,
        "top_choice_message": "Hello,\nI'm very excited about this opportunity and believe my background in digital marketing would be a perfect fit. Please find my resume attached.\nBest regards,\nSarah",
        "first_name": "Sarah",
        "last_name": "Johnson",
        "full_name": "Sarah Johnson",
        "headline": "Digital Marketing Director | SEO | Content Strategy | E-commerce",
        "public_identifier": "sarahjohnsondigital",
        "profile_url": "https://www.linkedin.com/in/sarahjohnsondigital",
        "location": "London, United Kingdom",
        "experiences": [
          {
            "title": "Digital Marketing Director",
            "company": "TechGrowth Solutions",
            "company_url": "https://www.linkedin.com/company/techgrowth-solutions/",
            "date_range": "5/2022 - Present",
            "description": "Leading a team of 12 marketing specialists across SEO, content, and paid acquisition channels. Developed and executed comprehensive marketing strategies that increased organic traffic by 78% and improved conversion rates by 34% within 18 months."
          },
          {
            "title": "Senior Marketing Manager",
            "company": "E-Commerce Innovators",
            "company_url": "https://www.linkedin.com/company/ecommerce-innovators/",
            "date_range": "3/2019 - 5/2022",
            "description": "Managed digital marketing initiatives for B2B SaaS platform. Implemented data-driven marketing strategies that generated 12M in pipeline and contributed to 25% YoY revenue growth."
          }
        ],
        "education": [
          {
            "school": "University of Manchester",
            "school_url": "https://www.linkedin.com/school/university-of-manchester/",
            "degree": "Master's degree, Digital Marketing",
            "field": "Marketing",
            "years": "2016 - 2018"
          },
          {
            "school": "King's College London",
            "school_url": "https://www.linkedin.com/school/kings-college-london/",
            "degree": "Bachelor's degree, Business Administration",
            "field": "Marketing and Communications",
            "years": "2012 - 2016"
          }
        ],
        "responses": {
          "Do you have experience with SEO and SEM strategies?": "Yes, I have 8+ years of experience developing and implementing SEO/SEM strategies for e-commerce and SaaS companies. My recent campaign increased organic traffic by 78% year-over-year.",
          "Are you willing to relocate?": "Yes, I'm open to relocation opportunities."
        },
        "application_date": "2025-04-15 10:27:39",
        "contact_email": "[email protected]",
        "contact_phone": "+44 7700 900123"
      }
    ]
  }
  "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 10,
      "pages_fetched": 1
    }
}