API Reference/Endpoints
List job applicants
GET/api/linkedin/gateway/linkedin/jobs/{id}/applicants
Lists everyone who has applied to a job posting, with their profile, resume-adjacent experience, and any screening-question answers.
Authentication
Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.
Path parameters
FieldTypeDescription
id *stringThe job posting's id.
Query parameters
FieldTypeDescription
account_id *stringThe connected account the posting belongs to.
service"CLASSIC" | "RECRUITER"Which service to read applicants from. Defaults to Classic.
keywordsstringFree-text filter over applicant profiles.
ratingsstringA comma-separated list of UNRATED, GOOD_FIT, MAYBE, NOT_A_FIT to filter by.
sort_by"relevance" | "alphabetical" | "newest_first" | "screening_requirements"Ordering for the returned list.
min_years_in_company / max_years_in_companynumberRecruiter filter on tenure at the applicant's current company.
min_years_in_position / max_years_in_positionnumberRecruiter filter on tenure in the applicant's current role.
min_years_of_experience / max_years_of_experiencenumberRecruiter filter on total years of experience.
include_degree / exclude_degreestring[]Recruiter filter to include or exclude specific degrees.
limitintegerMax results per page, from 1 to 250.
cursorstringPass back the cursor from a previous page to keep paging.
Applicant object
FieldTypeDescription
idstringThe applicant's id — pass it to Retrieve a job applicant.
profile_id / public_identifier / public_profile_urlstringThe applicant's LinkedIn profile identifiers.
name / headline / locationstringBasic profile details shown on the application.
profile_picture_urlstringThe applicant's profile picture.
applied_atnumberUnix timestamp of the application.
rating"UNRATED" | "GOOD_FIT" | "MAYBE" | "NOT_A_FIT"The rating a member of the hiring team has assigned, if any.
email_address / phone_numberstringTop-level contact fields, mirrored inside contact_info.
contact_infoobjectemail_addresses[] and phone_numbers[] the applicant has on file.
work_experiencearrayPrior roles, each with company, position and a start/end year-month.
educationarraySchools attended, each with degree, field of study and a start/end year-month.
screening_questionsarrayEach posting question paired with the applicant's answers and whether they success-fully cleared it.
The years-of-tenure, degree and rating filters only take effect with service=RECRUITER on an account with a Recruiter/Talent seat — against a Classic account they're accepted but ignored.
Errors
·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.·404 Not Found. No job posting with that id belongs to this account.
