Skip to main content
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
    }
}

Documentation Index

Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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, APPLIED_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, DE, NL, IT, IL, CA, BR, ES, IN)
​
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
    }
}