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.
Body Parameters
LinkedIn job posting ID (e.g., “4178681649”, you can get it with the /recruiter/posts endpoint)
Number of profiles to retrieve
First page to fetch when using pagination mode (default: 1)
Last page to fetch when using pagination mode (default: same as start_page)
Starting position for pagination
sortType
string
default:"RELEVANCE"
Sorting method. Options: RELEVANCE, 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”)
Filter candidates by location (e.g., “Paris”)
Filter by years of experience, comma-separated (e.g., “THREE_TO_FIVE_YEARS,SIX_TO_TEN_YEARS”)
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
LinkedIn authentication cookie () obtained from the login/verify process
Response
Request status (success/error)
Total number of candidates retrieved
List of candidate profiles
data.candidates[].application_id
Unique ID of the application
Recruiter’s rating of the candidate (GOOD_FIT, MAYBE, UNRATED, NOT_A_FIT)
data.candidates[].is_top_choice
Whether the candidate is marked as a top choice
data.candidates[].top_choice_message
Message from candidate if marked as top choice
data.candidates[].first_name
Candidate’s first name
data.candidates[].last_name
Candidate’s last name
data.candidates[].full_name
Candidate’s full name
data.candidates[].headline
Candidate’s LinkedIn headline
data.candidates[].public_identifier
Candidate’s LinkedIn URL identifier
data.candidates[].profile_url
Complete LinkedIn profile URL
data.candidates[].linkedin_id
Candidate’s LinkedIn internal ID
data.candidates[].location
Candidate’s location
data.candidates[].experiences
List of candidate’s work experiences
data.candidates[].experiences[].title
Job title
data.candidates[].experiences[].company
Company name
data.candidates[].experiences[].company_url
LinkedIn URL of the company
data.candidates[].experiences[].date_range
Employment period
data.candidates[].experiences[].description
Job description
data.candidates[].education
List of candidate’s education history
data.candidates[].education[].school
School name
data.candidates[].education[].school_url
LinkedIn URL of the school/university
data.candidates[].education[].degree
Degree obtained
data.candidates[].education[].field
Field of study
data.candidates[].education[].years
Period of study
data.candidates[].responses
Candidate’s answers to job application questions
data.candidates[].application_date
Date and time when the application was submitted
data.candidates[].contact_email
Candidate’s email address
data.candidates[].contact_phone
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
}
}
