Organization Search

  • Article

Warning

Deprecation Notice
The Marketing version 202304 (Marketing April 2023) and below has been sunset and the unversioned APIs are going to be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

Warning

The /search?q=companiesV2 endpoint will be deprecated on August 31, 2021 and replaced with /companySearch?q=search Please see the New Company Search API page.

The Organization Search API to find organizations using keywords, industry, location, and other criteria. It returns a collection of matching organizations. Each entry can contain much of the information available on the organization page.

The API can also return facets. Facets provide you with data about the collection of organizations, such as which organizations are located in a certain area, size of the organizations, and the industry an organization is in. You can then use this data to make a new API call that further refines your original request. This is similar to using the filters on the left-hand side of the LinkedIn Search results page.

Note

The Organization Search endpoint is restricted. This permission is granted to select developers only.

Search for Organizations

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

Sample Request

GET https://api.linkedin.com/v2/search?q=companiesV2

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, a search is made for the complete string.
  • Wildcards and Boolean logic is not supported (for example: *, ?, AND, and OR).

Parameters

Field Description Format Required
baseSearchParams.keywords space-delimited, url-encoded search terms This is typically the organization name, but keywords hits will match this value anywhere in an organization listing. string No
companySearchParams.facetIndustry industry fields string array No
companySearchParams.facetNetwork network relationship string array No
companySearchParams.facetCompanySize organization size range string array No
companySearchParams.facetNumFollowersRange number of followers string array No
companySearchParams.facetFortune Fortune ranking string array No

Note

You should search for only a single organization at a time. All search parameters should be related to the single organization you intend to find.

Search by Keywords

Use baseSearchParams.keywords to search organizations by keywords.

Sample Request

GET https://api.linkedin.com/v2/search?q=companiesV2&baseSearchParams.keywords=LinkedIn%20Corporation

Search by Facets

Use the facet parameters within companySearchParams to search by one or more facets. Each facet may contain multiple values, so use bracket array notation, and be sure to url-encode the brackets (note encoded brackets %5B0 and %5BD in the request below).

Sample Request

GET https://api.linkedin.com/v2/search?q=companiesV2&baseSearchParams.keywords=LinkedIn%20Corporation&companySearchParams.facetIndustry%5B0%5D=6&companySearchParams.facetCompanySize%5B0%5D=H

Facet Details

Facet Definition Values
facetIndustry An industry field. Industry codes are listed on a separate page.
facetNetwork Collection of companies based on relationship. Valid values are:
  • F: First degree
  • S: Second degree
  • O: Out of network
facetCompanySize 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+
facetNumFollowersRange The company collection based on the number of followers. Valid values are:
  • NFR1: 1 - 50
  • NFR2: 51 - 100
  • NFR3: 101 - 1000
  • NFR4: 1001 - 5000
  • NFR5: 5001 to *
facetFortune The company collection based on the Fortune ranking. Valid values are:
  • 1: Fortune 50
  • 2: Fortune 51 - 100
  • 3: Fortune 101 - 250
  • 4: Fortune 251 - 500
  • 5: Fortune 501 - 1000

Search Response

By default, results will contain metadata for each facet hit and an organization URN for each search hit. You can get the id, name, localizedName, vanityName, logoV2, and location for each search hit using decoration in the request via the projection query parameter.

For example:

&projection=(elements*(entity~(vanityName)),paging)

Sample Response

{
    "elements": [
        {
            "entity~": {
                "vanityName": "linked-it"
            },
            "entity": "urn:li:organization:1032984"
        },
        {
            "entity~": {
                "vanityName": "linked"
            },
            "entity": "urn:li:organization:1333387"
        },
        {
            "entity~": {
                "vanityName": "linked-in"
            },
            "entity": "urn:li:organization:11673184"
        },
        {
            "entity~": {
                "vanityName": "linked-hr-linkedhr-"
            },
            "entity": "urn:li:organization:351062"
        },
        {
            "entity~": {
                "vanityName": "linked-executive-search"
            },
            "entity": "urn:li:organization:2257467"
        },
        {
            "entity~": {
                "vanityName": "linked-rh"
            },
            "entity": "urn:li:organization:3348356"
        },
        {
            "entity~": {
                "vanityName": "linked-education"
            },
            "entity": "urn:li:organization:10610729"
        },
        {
            "entity~": {
                "vanityName": "linked-local-network"
            },
            "entity": "urn:li:organization:1459903"
        },
        {
            "entity~": {
                "vanityName": "linked-quebec"
            },
            "entity": "urn:li:organization:1599550"
        },
        {
            "entity~": {
                "vanityName": "linked-com"
            },
            "entity": "urn:li:organization:3618227"
        }
    ],
    "paging": {
        "total": 12991,
        "count": 10,
        "start": 0,
        "links": [
            {
                "rel": "next",
                "href": "/v2/search?baseSearchParams.keywords=Linked&count=10&projection=%28elements*%28entity%7E%28vanityName%29%29%2Cpaging%29&q=companiesV2&start=10",
                "type": "application/json"
            }
        ]
    }
}