Company Search

The Company Search API enables search across company pages.

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 Company Search API to find companies using keywords, industry, location, or some other criteria. It returns a collection of matching companies. Each entry can contain much of the information available on the company page.

The API can also return facets. Facets provide you with data about the collection of companies, such as which companies are located in a certain area, size of the companies, and the industry a company is in. 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 Company Search API.

Refine your search by providing query parameters, such as keywords, industries, 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 Companies 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.)
hq-only N Matching companies by the headquarters location. When this is set to "true" and a location facet is used, this restricts returned companies to only those whose headquarters resides in the specified location.
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 110. 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:     
  • relevance
  • relationship
  • followers: Number of followers for a company.
  • company-size: Size of the company.

By default, results are ordered by the relevance.

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

Facets

Parameter Definition Values
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.
industry An industry field. Industry codes are listed on a separate page.
network Collection of companies based on relationship.
company-size The company collection based on size range specified. Valid values are:
  • B: 1-10
  • C: 11-50
  • D: 51-200
  • E: 201-500
  • F: 501-1000
  • G: 1001-5000
  • H: 5001-10,000
  • I: 10,000+
num-followers-range The company collection based on the number of followers.
fortune The company collection based on the Fortune ranking.

Sample Output XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<company-search>
  <companies total="4493" count="10" start="0">
    <company>
      <id>162479</id>
      <name>Apple Inc.</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/2/000/082/2e6/39570d2.png</logo-url>
      <type>Public Company</type>
    </company>
    <company>
      <id>1276</id>
      <name>Apple Retail</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/2/000/039/353/3e84d05.png</logo-url>
      <type>Public Company</type>
    </company>
    <company>
      <id>1373</id>
      <name>Xerox</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/2/000/014/3d1/21af29f.png</logo-url>
      <type>Public Company</type>
    </company>
    <company>
      <id>163801</id>
      <name>FileMaker</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/2/000/05e/384/25520f9.png</logo-url>
      <type>Public Company</type>
    </company>
    <company>
      <id>165158</id>
      <name>Netflix</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/3/000/058/201/1aa9aa0.png</logo-url>
      <type>Public Company</type>
    </company>
    <company>
      <id>19271</id>
      <name>Apple Vacations</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/1/000/066/291/33c3a4d.png</logo-url>
      <type>Privately Held</type>
    </company>
    <company>
      <id>772044</id>
      <name>Stone Apple Solutions</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/1/000/047/0aa/3e536ab.png</logo-url>
      <type>Privately Held</type>
    </company>
    <company>
      <id>88452</id>
      <name>Apple REIT Companies</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/</logo-url>
      <type>Public Company</type>
    </company>
    <company>
      <id>112136</id>
      <name>Apple & Associates</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/2/000/075/322/292f760.png</logo-url>
      <type>Privately Held</type>
    </company>
    <company>
      <id>21482</id>
      <name>GHA Technologies</name>
      <logo-url>http://media.linkedin.com/mpr/mpr/p/3/000/051/38b/17fe472.png</logo-url>
      <type>Privately Held</type>
    </company>
  </companies>
  <num-results>4493</num-results>
  <facets total="1">
    <facet>
      <code>location</code>
      <name>Location</name>
      <buckets total="10">
        <bucket>
          <code>us:0</code>
          <name>United States</name>
          <count>1548</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>gb:0</code>
          <name>United Kingdom</name>
          <count>403</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>us:84</code>
          <name>San Francisco Bay Area</name>
          <count>204</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>nl:0</code>
          <name>Netherlands</name>
          <count>182</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>us:70</code>
          <name>Greater New York City Area</name>
          <count>178</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>ca:0</code>
          <name>Canada</name>
          <count>164</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>us:49</code>
          <name>Greater Los Angeles Area</name>
          <count>106</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>gb:4573</code>
          <name>London, United Kingdom</name>
          <count>97</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>au:0</code>
          <name>Australia</name>
          <count>93</count>
          <selected>false</selected>
        </bucket>
        <bucket>
          <code>in:0</code>
          <name>India</name>
          <count>91</count>
          <selected>false</selected>
        </bucket>
      </buckets>
    </facet>
  </facets>
</company-search>