Company 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.
The Company Search API to find companies using keywords, industry, location, and other criteria. It returns a collection of matching companies. Each entry can contain an entity field represented by an organization URN.
The API also supports filters to further refine your request, which is similar to using the filters on the left-hand side of the LinkedIn Search results page.
Note
The Company Search endpoint is restricted. This permission is granted to selected developers only.
Search for Companies
Here are a few examples of how to use the Company 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 |
---|---|---|---|
query | This is typically the organization name, but keyword hits will match this value anywhere in an organization listing. Format is space-delimited, url-encoded search terms, and requires a minimum of 3 characters. | string | No |
filter.industry | industry fields | string array | No |
filter.industryV2 | industry V2 fields | string array | No |
filter.networkDegree | network relationship | string array | No |
filter.companySize | organization size range | string array | No |
filter.followersSize | number of followers | string array | No |
filter.fortune | Fortune ranking | string array | No |
Note
You should search for only a single company at a time. All search parameters should be related to the single company you intend to find.
Search by Keywords
Use query
to search companies by keywords.
Sample Request
Search by Filters
Use the filter parameters to search by one or more facets. Each filter 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/companySearch?q=search&query=LinkedIn%20Corporation&filter.industry%5B0%5D=6&filter.companySize%5B0%5D=H
Filter Details
Filter | Definition | Values |
---|---|---|
industry | Deprecated on June 30, 2022. Use industryV2 field instead. | Industry codes are listed on a separate page. |
industryV2 | An industry field. | Industry V2 codes are listed on a separate page. |
networkDegree | Collection of companies based on relationship. | Valid values are: |
companySize | The company collection based on size range specified. | Valid values are: |
followersSize | The company collection based on the number of followers. | Valid values are: |
fortune | The company collection based on the Fortune ranking. | Valid values are: |
Search Response
By default, results will contain an organization URN for each search hit. You can get the id
, name
, localizedName
, vanityName
, logoV2
, and locations
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/companySearch?q=search&query=Linked&count=10&projection=%28elements*%28entity%7E%28vanityName%29%29%2Cpaging%29&start=0",
"type": "application/json"
}
]
}
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla