LinkedIn

Get a LinkedIn job

Returns any public job by id or job URL, with the full description, applicant count, apply link and hiring team that job listings and search leave out. Salary, seniority, skills, screening questions and views are not returned for jobs posted by other companies.

GET

/api/v1/linkedin/jobs/{jobId}

Path parameters

jobId

required

string

Numeric job id from a job listing or search, or a job URL such as https://www.linkedin.com/jobs/view/4447604185 (URL-encoded when sent in the path).

Query parameters

connectedAccountId

required

string · uuid

Connected account to act as

service

optional

"classic" | "recruiter"

recruiter for a job posted through LinkedIn Recruiter, which needs a Recruiter seat on the connected account. Defaults to classic.

Response

200LinkedIn job.

job

object

id

string

url

string

state

"active" | "draft" | "review" | "closed" | "paused"

title

string

description

string | null

location

string

companyId

string | null

Numeric company id, accepted as identifier by /companies.

companyName

string | null

applicantCount

number

createdAt

string · date-time | null

publishedAt

string · date-time | null

closedAt

string · date-time | null

applyUrl

string | null

External application page, when the job links to one.

hiringTeam

object[] | null

salary

string | null

Not returned for jobs posted by other companies.

workplace

string | null

Not returned for jobs posted by other companies.

seniority

string | null

Not returned for jobs posted by other companies.

skills

string[] | null

Not returned for jobs posted by other companies.

functions

string[] | null

Not returned for jobs posted by other companies.

industries

string[] | null

Not returned for jobs posted by other companies.

screeningQuestions

object[] | null

Not returned for jobs posted by other companies.

viewCount

number | null

Not returned for jobs posted by other companies.

cost

number

0 for jobs posted by other companies.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy