Get Candidates

POST

recruiter

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)

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
    }
}

Get LinkedIn Feed Get Candidate CV

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
    }
}

Getting Started

Error Handling

Authentication

Profile

Companies

Network

Messages

posts

recruiter

Header Parameters

Body Parameters

Response

Getting Started

Error Handling

Authentication

Profile

Companies

Network

Messages

posts

recruiter

​Header Parameters

​Body Parameters

​Response

Header Parameters

Body Parameters

Response