Company Lookup API and Fields

The Company Profile API:

  • Retrieves and displays one or more company profiles based on the company ID or universal name.
  • Returns basic company profile data, such as name, website, and industry.
  • Returns handles to additional company content, such as RSS stream and Twitter feed.

Now you can learn all about the companies related to the members using your application. So, not only can you display their profile, but also information about their employer.

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 Profile API to find companies using a company ID, a universal name, or an email domain. You can retrieve data for individual or multiple companies. The API returns a list of companies with matching profiles. Each entry can contain the basic company information available in the company profile (such as company ID, logo, site URL, and more) and handles to additional company content (such as RSS stream or Twitter feed).

Here are a few examples showing how to use the basics of the Company Profile API. For example, retrieve a company by using the company ID. This returns a single company if found.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<company>   <id>162479</id>   <name>Apple</name> </company>

You can retrieve an id for a company using member profile calls, such as http://api.linkedin.com/v1/people/~:(first-name,last-name,headline,positions:(company:(name,id))).

Retrieve a company by universal-name.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<company>   <id> 1337</id>   <name>LinkedIn</name> </company>

Use the email-domain collection filter to get all matching companies.

This returns an array of companies that match to the specified email domain.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companies total="2">
  <company>
   <id>162479</id>
   <name>Apple Inc.</name>
  </company>
  <company>
   <id>1276</id>
   <name>Apple Retail</name>
  </company>
</companies>

You can make a bulk request and mix ID and univeral-name. This returns a list of companies that match the keys provided.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companies total="2"> <company key="162479">    <id>162479</id>    <name>Apple</name>   </company>   <company key="universal-name=linkedin">    <id> 1337</id>    <name>LinkedIn</name>   </company> </companies>

You can also fetch a list of all companies the authenticated user is an administrator of

1
2
3
4
5
6
7
8
9
10
11
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companies total="2">
  <company>
    <id>123456</id>
    <name>Test Company 1</name>
  </company>
  <company>
    <id>1337</id>
    <name>LinkedIn</name>
  </company>
</companies>

Input Values

The following tables list the input values used to retrieve company information. You must use at least one value to retrieve data.

Keys

The following input values are key values. Keys return data for a single company. The keys use the following syntax: companies/<key>.

Parameter Required Definition
universal-name N

The unique string identifier for a company.

id N

The unique internal numeric company identifier.

Filters

The following input value is a collection filter. Collection filters return an array of company records. The filter uses the following syntax: companies?<filter>.

Parameter Required Definition
email-domains N

Company email domains.

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

The following fields are returned by default: id and name. Use Field Selectors to retrieve the additional fields listed below. For example:

Parameter Definition
id Default. The unique internal numeric company identifier.
name

Default. The human readable name of the company.

universal-name The unique string identifier for a company.
email-domains Company email domains.
company-type

Type of company. Valid values are:

  • C ("Public Company")
  • D ("Educational")
  • E ("Self Employed")
  • G ("Government Agency")
  • N ("Non Profit")
  • O ("Self Owned")
  • P ("Privately Held")
  • S ("Partnership")

Use this field instead of the deprecated type field.

ticker

Company ticker identification for the stock exchange. Available only for public companies.

website-url

Company web site address.

industries

A collection containing a code and name pertaining to the company's industry. See Industry Codes for the list of industries available.

status

Company status. Valid values are:

  • OPR ("Operating")
  • OPS ("Operating Subsidiary")
  • RRG ("Reorganizing")
  • OOB ("Out of Business")
  • ACQ ("Acquired")
logo-url

URL for the company logo in JPG format.

square-logo-url

URL for the company logo in a square format.

blog-rss-url

URL for the company blog.

twitter-id

Handle for the company Twitter feed.

employee-count-range

Number range of employees at the company. Use this field instead of the deprecated size field. Valid values are:

  • A:1
  • B: 2-10
  • C: 11-50
  • D: 51-200
  • E: 201-500
  • F: 501-1000
  • G: 1001-5000
  • H: 5001-10,000
  • I: 10,000+
specialties

Company specialties. Retrieves information from string input.

locations

Company location.

locations:(description)

Description of company location.

locations:(is-headquarters) Valid values are true or false. A value of true matches the Company headquarters location.
locations:(is-active) Valid values are true or false. A value of true matches the active location.
locations:(address)

Address of location.

locations:(address:(street1))

First line of street address of location.

locations:(address:(street2))

Second line of street address of location.

locations:(address:(city))

City for location.

locations:(address:(state))

State for location.

locations:(address:(postal-code))

Postal code for location. Matches companies within a specific postal code. Must be combined with the country-code parameter. Not supported for all countries.

locations:(address:(country-code))

Country code for location. Matches companies with a location in a specific country.

locations:(address:(region-code))

Region code for location.

locations:(contact-info)

Company contact information for the location.

locations:(contact-info:(phone1))

Company phone number for the location.

locations:(contact-info:(phone2))

Second company phone number for the location.

locations:(contact-info:(fax))

Company fax number for the location.

description

Company description. Limit of 500 characters.

stock-exchange

Stock exchange the company is in. Available only for public companies. Valid values are:

  • ASE (1, "American Stock Exchange")
  • NYS (2, "New York Stock Exchange")
  • NMS (3, "NASDAQ")
  • LSE (4, "London Stock Exchange")
  • FRA (5, "Frankfurt Stock Exchange")
  • GER (6, "XETRA Trading Platform")
  • PAR (7, "Euronext Paris")
founded-year

Year listed for the company's founding.

end-year

Year listed for when the company closed or was acquired by another.

num-followers

The number of followers for the company's profile.

Sample Output XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<company>   <id>1337</id>   <universal-name>linkedin</universal-name>   <name>LinkedIn</name>   <ticker>LNKD</ticker>   <logo-url>http://media.linkedin.com/mpr/mpr/p/2/000/072/3f9/35d2127.png</logo-url>   <description>LinkedIn takes your professional network online, giving you access to people, jobs and opportunities like never before. Built upon trusted connections and relationships, LinkedIn has established the worldÕs largest and most powerful professional network. Currently, more than 200 million professionals are on LinkedIn, including executives from all five hundred of the Fortune 500 companies, as well as a wide range of household names in technology, financial services, media, consumer packaged goods, entertainment, and numerous other industries. LinkedIn is backed by world-class investors including Sequoia Capital, Greylock, the European Founders Fund, Bessemer Venture Partners, Bain Capital, Goldman Sachs, SAP Ventures, and The McGraw-Hill Companies</description>   <company-type>     <code>P</code>     <name>Privately Held</name>   </company-type> <industries total="1"> <industry> <code>6</code> <name>Internet</name> </industry> </industries>   <size>501-1000</size>   <specialties total="8">     <specialty>Online Professional Network</specialty>     <specialty>Jobs</specialty>     <specialty>People Search</specialty>     <specialty>Company Search</specialty>     <specialty>Address Book</specialty>     <specialty>Advertising</specialty>     <specialty>Professional Identity</specialty>     <specialty>Group Collaboration</specialty>   </specialties>   <blog-rss-url>http://feeds.feedburner.com/LinkedInBlog</blog-rss-url>   <twitter-id>linkedin</twitter-id>   <square-logo-url>http://media.linkedin.com/mpr/mpr/p/3/000/072/3db/1283f2d.png</square-logo-url>   <locations total="15">     <location>       <address>         <street1>2029 Stierlin Court</street1>         <city>Mountain View</city>         <postal-code>94043</postal-code>       </address>       <contact-info>       </contact-info>     </location>     <location>       <address>         <street1>2126 N 117th Ave</street1>         <city>Omaha</city>         <postal-code>68164</postal-code>       </address>       <contact-info>         <phone1>(402) 452-2320</phone1>       </contact-info>     </location>     <location>       <address>         <street1>15 Shady Brook Lane</street1>         <city>Belmont</city>         <postal-code>02478</postal-code>       </address>       <contact-info>       </contact-info>     </location>     <location>       <address>         <street1>2126 N 117th Ave</street1>         <city>Omaha</city>         68164</postal-code>       </address>       <contact-info>         <phone1>(402) 452-2320</phone1>       </contact-info>     </location>     <location>       <address>         <street1>2029 Stierlin Court</street1>         <city>Mountain View</city>         <postal-code>94043</postal-code>       </address>       <contact-info>       </contact-info>     </location>     <location>       <address>         <street1>2029 Stierlin Court</street1>         <city>Mountain View</city>         <postal-code>94043</postal-code>       </address>       <contact-info>       </contact-info>     </location>     <location>       <address>         <street1>30 S. Wacker Drive</street1>         <city>Chicago</city>         <postal-code>60606</postal-code>       </address>       <contact-info>       </contact-info>     </location>   </locations>   <founded-year>2003</founded-year>   <email-domains total="1">     <email-domain>linkedin.com</email-domain>   </email-domains>   <website-url>http://www.linkedin.com</website-url>   <status>    <code>OPR</code>    <name>Operating</name>   </status>   <employee-count-range>     <code>F</code>     <name>501-1000</name>   </employee-count-range> </company>