API Reference/Endpoints

Retrieve a job posting

GET/api/linkedin/gateway/linkedin/jobs/{job_id}

Fetches the full current state of one job posting — its content, lifecycle stage, and running counters — by id.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription

job_id *stringThe job posting's id.

Query parameters

FieldTypeDescription

account_id *stringThe connected account the posting belongs to.

service *"CLASSIC" | "RECRUITER"Which LinkedIn service this posting lives under.

Response fields

FieldTypeDescription

idstringEchoes job_id.

statestringOne of active, draft, review, closed, paused.

title / description / location / salarystringThe posting's content as shown to candidates.

company / company_idstringThe hiring company's name and LinkedIn id.

workplacestringON_SITE, HYBRID, or REMOTE.

apply_urlstring | nullWhere an external apply_method sends candidates.

applicants_counter / views_counter / costnumberRunning totals since the posting went live.

created_at / published_at / closed_atnumber | nullUnix timestamps for each lifecycle transition that has happened.

skills / functions / industriesstring[]Tags attached to the posting.

screening_questionsarrayThe qualifying questions and their favorable answers.

hiring_teamarrayLinkedIn members listed as hiring contacts.

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.

{ "object": "LinkedinJobPosting", "id": "3897456210", "state": "active", "title": "Senior Product Designer", "description": "<p>We are looking for a senior product designer...</p>", "company": "Acme Corp", "company_id": "1035", "location": "San Francisco, California, United States", "workplace": "HYBRID", "seniority": "Mid-Senior level", "salary": "$150,000/yr - $190,000/yr", "apply_url": null, "applicants_counter": 42, "views_counter": 1180, "cost": 0, "created_at": 1767225600, "published_at": 1767229200, "closed_at": null, "skills": ["Figma", "Design systems"], "functions": ["Design"], "industries": ["Software Development"], "screening_questions": [ { "question": "Do you have 5+ years of product design experience?", "favorableAnswers": ["Yes"] } ], "hiring_team": [ { "name": "Andy Nguyen", "provider_id": "ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ", "public_identifier": "andy-nguyen", "can_send_free_inmail": true } ] }