API Overview
The LinkedIn's Job Posting API allows members to automatically post jobs to LinkedIn from their Applicant Tracking System (ATS), instead of manually posting using the website. This API enables partners to post and manage lifecycle for both basic or promoted jobs. The promoted jobs via API get promoted directly to paid job slots of LinkedIn Recruiter customers. Not all partners have the capability to post promoted jobs. To request for access, please reach out to your LinkedIn Business Development point of contact.
Note
If you are not yet a LinkedIn Talent Solutions Partner, please complete the LinkedIn Talent Solutions Partner Request Form
Note
Please note that in some cases, we may require certain types of jobs to be promoted on LinkedIn. Jobs that require promotion may include jobs by companies with generic names (such as “Confidential Company”) or jobs from search and staffing companies. These limits are designed to prevent abuse, improve product quality, and increase transparency while ensuring that job seekers have access to the best possible opportunities. Please note that LinkedIn reserves the right to require promotion of jobs.
Job Posting API Schema
In order to publish a job, you need to construct the request body with all required fields. The more information your application can provide, the more candidates can be reached to satisfy customers’ needs. To post basic jobs, refer to Foundation schema. To enable advanced features on job posting, refer to Extension schema
Important
For a given customer, when their first job is sent via the SJP API, all the customer’s open, public jobs should be sent via API. All future public jobs should also be sent via API.
Job Posting Operations
Listed below are the four job posting operations supported by LinkedIn:
- Create
- Close
- Update
- Renew
Note
- For all the above operations, value for
jobPostingOperationType
field in API schema determines the operation to be performed. - For example, use
jobPostingOperationType
asCREATE
in request body to create a job.
Post Jobs on LinkedIn
API Endpoint
Use the following endpoint to submit a task to create, close, update, or renew one or more jobs asynchronously:
POST https://api.linkedin.com/v2/simpleJobPostings
API Authorization
All requests below require access tokens obtained via the OAuth2.0 Client Credentials flow.
Important
We strongly recommend to use same access token for all concurrent and consecutive calls. An access token has a lifespan of 30 mins. Only on expiry of the existing token, new token should be generated.
API Throttling
Throttle Limits | Requests Per Day (UTC) | Records Per Minute | Records Per Day |
---|---|---|---|
Application maximum | 100,000 | 2,000 (applicable only for Promoted jobs) | 60,000 (applicable only for Promoted jobs) |
Refer to the below sections for sample requests and responses for each operation type.
Sample Request Body
We have provided below wiki pages to help with API request samples as well as error guide tables based on the following job posting operation type:
Continue RSC Development
In case you are building with RSC program, you can continue developing the remaining modules using RSC Sync Candidates