Skip to main content
POST
Get Candidates
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