Skip to main content
POST
Job Details

Job Details

Cost: 1 credit / successful request. (include_hiring_team adds 1 credit, charged only when the section is returned.) Get structured data for a single LinkedIn job posting. Provide either the numeric job ID or any LinkedIn job URL — the API extracts the ID for you. data is the posting itself: its own fields, the apply counts and links alongside them, and the hiring company nested under company_info. Every request returns the same set of keys; a field a posting does not publish comes back as null rather than being omitted, so your parsing code never has to branch.

Job details endpoint

Required attributes

string
The numeric LinkedIn job posting ID, e.g. "4443378596".Either job_id or url is required. If both are supplied, job_id wins.
string
Any LinkedIn job URL. The posting ID is extracted automatically from all common formats:
  • https://www.linkedin.com/jobs/view/4443378596
  • https://www.linkedin.com/jobs/view/generative-ai-engineer-at-hcltech-4443378596
  • https://www.linkedin.com/jobs/search/?currentJobId=4443378596

Optional attributes

boolean
default:"false"
Adds the hiring_team key: the job poster and any recruiters LinkedIn lists on the posting, with their name, headline, profile URL and photo.Costs an additional 1 credit, charged only when the section is returned. A posting with nobody listed returns an empty members array and is billed; a posting whose hiring team could not be retrieved omits the key entirely and is not billed.
This endpoint also accepts GET with the same attributes as query parameters, e.g. GET /api/v1/jobs/detail?job_id=4443378596&include_hiring_team=true.

Response

The job details model

Properties

boolean
Whether the posting was retrieved.
string
A human-readable status. On failure this explains what went wrong.
integer
Credits charged for the posting itself. 0 on any error response.
integer
Extra credits charged for optional sections that were returned.
object | null
The job posting. null on any error response.

Hiring team example

With include_hiring_team set to true, the hiring_team key is added to data:
hiring_team

Field availability

Every response carries every key. What varies is what the posting itself publishes:

Credits

An optional section that could not be returned is not charged. Failed requests (4xx, 5xx) are never charged.

Errors

Example

Example