Job Search API

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


The Job Search API enables search across LinkedIn's job postings.

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

Use the Job Search API to find jobs using keywords, company, location, or some other criteria. It returns a collection of matching jobs. Each entry can contain much of the information available on the job listing.

The API can also return facets. Facets provide you with data about the collection of jobs, such as which companies have posted the jobs, what type of jobs are posted, and where they are located. You can then use this data to make a new API call that further refines your original request. This is similar to clicking the buttons on the left-hand side of the LinkedIn Search results page.

Here are a few examples of how to use the basics of the Job Search API.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<job-search>
  <jobs count="10" start="0">
    <job>
      <id>1547469</id>
      <company>
      </company>
      <compensation>
        <salary>
          <pay-interval>
          </pay-interval>
        </salary>
      </compensation>
      <job-poster>
        <id>S-TTGn8IK9</id>
        <first-name>Heather</first-name>
        <last-name>Cavanagh</last-name>
        <headline>Legal Recruitment Administrator at SNR Denton
      </job-poster>
      <description-snippet>Position Description:SNR Denton US LLP is seeking an Associate for the Real Estate group for the New York office. Candidates should have 1-2 years real estate or related experience. Candidates with real estate lending experience are preferred. Who to Contact:Please submit resume, cover letter and law school transcript to heather.cavanagh@snrdenton.com</description-snippet>
      <location-description>Greater New York City Area</location-description>
    </job>
</job-search>

Refine your search by providing query parameters, such as keywords, job-title, location, and so on.

See the People Search API Overview for additional search query information.

Input Values

Unless otherwise specified:

  • All input is case insensitive.
  • Multiple words should be joined using a space. Since you need to URL encode input, this translates to %20. For example, Andrew%20Clark.
  • When you pass in multiple words, we search for that complete string.
  • Wildcards and Boolean logic is not supported (for example: *, ?, AND, and OR).
  • When you want to search for either of two terms, use facets. To find all people in the United States or France, you cannot do country-code=us,fr; instead, you need to do facet=location,us:0,fr:0
Parameter Required Definition
keywords N Jobs that have all the keywords anywhere in their listing. Multiple words should be separated by a space. (Don't forget to URL encode this data.)
company-name N Jobs with a matching company name.

It's often valuable to not be too specific with the company name. LinkedIn has made great efforts at standardizing company names, but including suffixes such as "Inc" and "Company" may overly limit your search, missing people who did not include those suffixes on their company names. It's usually better to  search for the basic name of the company and all different versions will be returned. This does increase the possibility of a false positive match return, though, so consider the most specific terms you can use. For example, consider using "Acme" instead of "Acme, Inc" to find people from a company called Acme, Inc. But this runs the risk of finding people from different companies with Acme in the title, such as "Acme Vending" and "Acme Services".

job-title N Matches jobs with the same job title.
country-code N Matches jobs with a location in a specific country. Values are defined in by ISO 3166 standard. Country codes must be in all lower case.
postal-code N Matches jobs centered around a Postal Code. Must be combined with the country-code parameter. Not supported for all countries.
distance N Matches jobs within a distance from a central point. This is measured in miles. This is best used in combination with both country-code and postal-code.
facet N Facet values to search over. Full information is below.
facets N Facet buckets to return. Full information is below.
start N Start location within the result set for paginated returns. This is the zero-based ordinal number of the search return, not the number of the page. To see the second page of 10 results per page, specify 10, not 1. Ranges are specified with a starting index and a number of results (count) to return. The default value is 0.
count N The number of jobs to return. Values can range between 0 and 20. The default value is 10. The total results available to any user depends on their account level.
sort N Controls the search result order. There are the following options:      
  • R (relationship): Relationship from job to member.
  • DA (date-posted-asc): Date posted in ascending order.
  • DD (date-posted-desc): Date posted in descending order.

By default, results are ordered by the relationship.

See Job Lookup API and Fields for the list of output fields.

Facets

Parameter Definition Values
company The job postings by company.
date-posted The job postings by the date posted. Format: YearMonthDay (e.g. 20121031)
location A geographical region. This is not necessarily a country. It could be a city or regional area, such as San Francisco Bay Area. A geographical code, such as us:84 for San Francisco Bay Area or fr:0 for France.
job-function The job postings by job function.
industry An industry field. Industry values are listed on a separate page.
salary The job postings based on salary.

Sample Output XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<job-search>
  <jobs count="3" start="0">
    <job>
      <id>1550983</id>
      <position>
        <location>
          <name>San Francisco Bay Area</name>
          <country>
            <code>us</code>
          </country>
        </location>
      </position>
      <job-poster>
        <first-name>David</first-name>
        <last-name>Sides</last-name>
        <relation-to-viewer>
          <distance>-1</distance>
        </relation-to-viewer>
      </job-poster>
      <posting-date>
        <year>2011</year>
        <month>4</month>
        <day>14</day>
      </posting-date>
    </job>
    <job>
      <id>1550465</id>
      <position>
        <location>
          <name>San Francisco Bay Area</name>
          <country>
            <code>us</code>
          </country>
        </location>
      </position>
      <job-poster>
        <first-name>Jeanmarie</first-name>
        <last-name>Boben</last-name>
        <relation-to-viewer>
          <distance>3</distance>
        </relation-to-viewer>
      </job-poster>
      <posting-date>
        <year>2011</year>
        <month>4</month>
        <day>14</day>
      </posting-date>
    </job>
    <job>
      <id>1549868</id>
      <position>
        <location>
          <name>San Francisco Bay Area</name>
          <country>
            <code>us</code>
          </country>
        </location>
      </position>
      <job-poster>
        <first-name>Anne</first-name>
        <last-name>Woods, CPA</last-name>
        <relation-to-viewer>
          <distance>3</distance>
        </relation-to-viewer>
      </job-poster>
      <posting-date>
        <year>2011</year>
        <month>4</month>
        <day>14</day>
      </posting-date>
    </job>
  </jobs>
</job-search>