Organization Search
Warning
Deprecation Notice
The Marketing Version 202308 (Marketing August 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will 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
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:
|
facetCompanySize | The company collection based on size range specified. | Valid values are:
|
facetNumFollowersRange | The company collection based on the number of followers. | Valid values are:
|
facetFortune | The company collection based on the Fortune ranking. | Valid values are:
|
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"
}
]
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for