Job Lookup API and Fields

Jobs API is a part of our Vetted API Access Program. You must apply here and get LinkedIn's approval before using this API.

The Jobs APIs provide access to view jobs and job data.

Hacker Summary

Usage

Authentication
You must use an access token to make an authenticated call on behalf of a user

Throttle Limits
Please reference the limits applied to this API

Overview

The Jobs API returns detailed information about job postings on LinkedIn. Find the job summary, description, location, and apply our professional graph to present the relationship between the current member and the job poster or hiring manager. Use inline filters and LinkedIn's unique nested domain structure to explore details about the job and the hiring company within a single REST call.

Input Values

Parameter Required Definition
id Y

The unique identifier for a job.

Unless otherwise specified:

  • All input is case insensitive.
  • Multiple words should be joined using a space. Because you need to URL encode input, this translates to %20. For example, Apple%20Inc.
  • When you pass in multiple words, we search for that complete string.
  • Wildcards and Boolean logic is not supported (for example: *, ?, AND, and OR).

Output Fields

Use Field Selectors to retrieve the specific fields listed below. For example:

Parameter Definition
id Default. The job ID.
customer-job-code Default. Customer entered job code.
active Default. Indicates whether or not this is an active job posting. Boolean.
posting-date Date of job posting. Format is YearMonthDay or YearMonth.
expiration-date The expiration for the job posting. Format is YearMonthDay or YearMonth.
posting-timestamp Default. The timestamp for the job posting. Time is in milliseconds.
expiration-timestamp The timestamp for the job posting expiration. Time is in milliseconds.
company:(id) Unique ID for the hiring company.
company:(name) Name of the hiring company.
position:(title) Title of the posted position.
position:(location) Location for the position being posted. Can contain the country code, postal code, and name.
position:(job-functions) Function for the position. See Job Functions for the list of functions available.
position:(industries) Function for the position. See Industry Codes for the list of industries available.
position:(job-type) Job type for the position being posted. See Job Types for the list of types available.
position:(experience-level) Experience level for the position being posted. See Experience Levels for the list of experience levels available.
skills-and-experience Description of the skills and experience needed for the posted position
description-snippet Default. Short description for the position.
description The full description for the position.
salary The salary listed for the posted job.
job-poster:(id) The ID for the person who posted the position.
job-poster:(first-name) The first name of the person who posted the position.
job-poster:(last-name) The last name of the person who posted the position.
job-poster:(headline) The headline title for the posted position.
referral-bonus Provides information if there is a referral bonus.
site-job-url The URL for the posted position.
location-description The description of the position's location.

Sample XML

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<job>
  <id>1511685</id>
        <expiration-timestamp>1304030488000</expiration-timestamp>
        <company>
                <id>229433</id>
                <name>Cloudera</name>
        </company>
        <position>
                <title>Technical Writer</title>
                <location>
                        <name>San Francisco Bay Area</name>
                        <country>
                                <code>us</code>
                        </country>
                </location>
        </position>
        <location-description>San Francisco or Palo Alto, CA</location-description>
        <job-poster>
                <id>hQ4ruu3J2q</id>
                <first-name>Paul</first-name>
                <last-name>Battaglia</last-name>
                <headline>Technical Writer at Cloudera</headline>
        </job-poster>
</job>