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
}
}
Recruiting
Get Candidates
Retrieve applicants for a LinkedIn job posting
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. Ignore this if you’re on per-seat pricing: usage is unlimited.
Header Parameters
string
required
Your API key
Body Parameters
string
required
LinkedIn job posting ID (e.g., “4178681649”, you can get it with the /recruiter/posts endpoint)
integer
default:"10"
Number of profiles to retrieve
integer
First page to fetch when using pagination mode (default: 1)
integer
Last page to fetch when using pagination mode (default: same as start_page)
string
default:"0"
Starting position for pagination
string
default:"RELEVANCE"
Sorting method. Options: RELEVANCE, APPLIED_DATE
string
default:"DESCENDING"
Sorting order. Options: ASCENDING, DESCENDING
string
default:"GOOD_FIT,MAYBE,UNRATED"
Candidate ratings to include, comma-separated (e.g, “GOOD_FIT,MAYBE,UNRATED,NOT_A_FIT”)
string
Filter candidates by location (e.g., “Paris”)
string
Filter by years of experience, comma-separated (e.g., “THREE_TO_FIVE_YEARS,SIX_TO_TEN_YEARS”)
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
string
required
LinkedIn authentication cookie () obtained from the login/verify process
Response
string
Request status (success/error)
object
Response data container
integer
Total number of candidates retrieved
array
List of candidate profiles
string
Unique ID of the application
string
Recruiter’s rating of the candidate (GOOD_FIT, MAYBE, UNRATED, NOT_A_FIT)
boolean
Whether the candidate is marked as a top choice
string
Message from candidate if marked as top choice
string
Candidate’s first name
string
Candidate’s last name
string
Candidate’s full name
string
Candidate’s LinkedIn headline
string
Candidate’s LinkedIn URL identifier
string
Complete LinkedIn profile URL
string
Candidate’s LinkedIn internal ID
string
Candidate’s location
array
List of candidate’s work experiences
string
Job title
string
Company name
string
LinkedIn URL of the company
string
Employment period
string
Job description
array
List of candidate’s education history
string
School name
string
LinkedIn URL of the school/university
string
Degree obtained
string
Field of study
string
Period of study
object
Candidate’s answers to job application questions
string
Date and time when the application was submitted
string
Candidate’s email address
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
}
}
Was this page helpful?