Get Job Candidates
curl --request POST \
--url https://api.linkupapi.com/v2/recruiter \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"job_id": "<string>",
"count": 123,
"offset": 123
}
}
'{
"success": true,
"data": {
"candidates": [
{
"application_id": "26905743894",
"rating": "UNRATED",
"is_top_choice": false,
"top_choice_message": "",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"headline": "Digital Marketing Strategist | SEO, SEM & Analytics",
"public_identifier": "jane-doe-42",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"location": "Paris, France",
"experiences": [
{
"title": "Digital Marketing Intern",
"company": "Acme Corp",
"company_url": "https://www.linkedin.com/company/acme-corp/",
"date_range": "2/2025 - 7/2025",
"description": ""
}
]
}
],
"total_results": 1,
"total_available_results": 81,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": 1,
"has_more": true,
"results_per_page": 50,
"pages_fetched": 1
}
},
"metadata": {
"action": "get_candidates",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Recruiting
Get Job Candidates
Retrieve candidates who applied to a specific job posting.
POST
/
v2
/
recruiter
Get Job Candidates
curl --request POST \
--url https://api.linkupapi.com/v2/recruiter \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"account_id": "<string>",
"action": "<string>",
"params": {
"job_id": "<string>",
"count": 123,
"offset": 123
}
}
'{
"success": true,
"data": {
"candidates": [
{
"application_id": "26905743894",
"rating": "UNRATED",
"is_top_choice": false,
"top_choice_message": "",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"headline": "Digital Marketing Strategist | SEO, SEM & Analytics",
"public_identifier": "jane-doe-42",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"location": "Paris, France",
"experiences": [
{
"title": "Digital Marketing Intern",
"company": "Acme Corp",
"company_url": "https://www.linkedin.com/company/acme-corp/",
"date_range": "2/2025 - 7/2025",
"description": ""
}
]
}
],
"total_results": 1,
"total_available_results": 81,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": 1,
"has_more": true,
"results_per_page": 50,
"pages_fetched": 1
}
},
"metadata": {
"action": "get_candidates",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Overview
Returns the candidates who applied to a specific job posting. Pagination is offset-based — setcount for the page size and offset to skip ahead.
This endpoint consumes 1 credit per 10 results returned. LinkedIn returns up to 50 candidates per internal request, so larger
count values trigger multiple upstream calls automatically.Request
Your API key for authentication.
The unique identifier of the account to use.
Must be
"get_candidates".Show params properties
Show params properties
The numeric LinkedIn job ID to retrieve candidates for.
Number of candidates to return. Defaults to
10. Capped at 1000 per call.Zero-indexed offset into the candidates list. Defaults to
0. Use pagination.next_offset from a previous response to fetch the next page.Response
Indicates whether the request was successful.
Show data properties
Show data properties
List of candidates.
Show candidate properties
Show candidate properties
Unique application ID — use it with
get_cv.Recruiter rating:
"UNRATED", "GOOD", "MAYBE", "NOT_A_FIT".true when the candidate marked the job as a top choice.Optional message left by the candidate.
First name.
Last name.
Full name.
LinkedIn headline.
Vanity slug.
LinkedIn profile URL.
Candidate location.
Work experience entries with
title, company, company_url, date_range (e.g. "2/2025 - 7/2025"), description.Number of candidates returned in this response.
Total number of candidates that applied to the job.
Show pagination properties
Show pagination properties
Offset of the first candidate in this response.
Number of candidates returned (mirrors
total_results).Offset to send as
offset in the next request. null when exhausted.true if more candidates are available.Maximum batch size used per upstream request (50).
Number of internal upstream batches consumed.
{
"success": true,
"data": {
"candidates": [
{
"application_id": "26905743894",
"rating": "UNRATED",
"is_top_choice": false,
"top_choice_message": "",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"headline": "Digital Marketing Strategist | SEO, SEM & Analytics",
"public_identifier": "jane-doe-42",
"profile_url": "https://www.linkedin.com/in/jane-doe-42",
"location": "Paris, France",
"experiences": [
{
"title": "Digital Marketing Intern",
"company": "Acme Corp",
"company_url": "https://www.linkedin.com/company/acme-corp/",
"date_range": "2/2025 - 7/2025",
"description": ""
}
]
}
],
"total_results": 1,
"total_available_results": 81,
"pagination": {
"offset": 0,
"count": 1,
"next_offset": 1,
"has_more": true,
"results_per_page": 50,
"pages_fetched": 1
}
},
"metadata": {
"action": "get_candidates",
"account_id": "your-account-id",
"credits_consumed": 1,
"timestamp": "2026-04-26T10:35:00Z"
}
}
Was this page helpful?
⌘I