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>"
}'
{
  "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, 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
{
  "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
    }
}