Get Candidates

Retrieve applicants for a LinkedIn job posting

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, 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)

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

Success Response

{
  "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": "[e-mail]",
        "contact_phone": "[phone]"
      }
    ]
  }
  "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 10,
      "pages_fetched": 1
    }
}