Searching for companies
This endpoint allows you to search for companies using various filters, and optionally retrieve additional company data.
POST https://api.linkedapi.io/account/companies.searchBody
{
"dataSource": "salesNavigator",
"searches": [
{
"searchId": "unique-id-1",
"term": "Tech Inc",
"limit": 2,
"filter": {
"sizes": ["51-200", "2001-500"],
"locations": ["San Francisco", "New York"],
"industries": ["Software Development", "Robotics Engineering"],
"annualRevenue": {
"min": "0",
"max": "2.5"
}
},
"include": {
"basicInfo": {}
}
},
{
"searchId": "unique-id-2",
"term": "Green Energy",
"limit": 2,
"filter": {
"sizes": ["1-10", "11-50"],
"locations": ["California", "Texas"],
"industries": ["Renewable Energy", "Forestry and Logging"],
"annualRevenue": {
"min": "10",
"max": "50"
}
}
}
]
}
dataSource– type of data source for the search. Enum with the following options:standard– standard LinkedIn search.salesNavigator– Sales Navigator search.
searches– array where each item represents a separate search query.searchId(optional) – unique identifier to correlate searches with results. If not provided, matches can still be determined by the order of searches and results.term(optional) – keyword or phrase to search.limit(optional) – number of search results to return. Defaults to 10, with a maximum value of 10.
include(optional) – object specifying additional company data to retrieve, following the structure of the retrieving companies data documentation.filter(optional) – filter configuration object, depends on the selecteddataSource. Configuration details are specified below.
Standard filter configuration
sizes(optional) – array of enums representing employee count ranges. Matches if company’s size falls within any of the listed ranges. Options:1-10.11-50.51-200.201-500.501-1000.1001-5000.5001-10000.10001+.
locations(optional) – array of free-form strings representing locations. Matches if company is headquartered in any of the listed locations.industries(optional) – array of enums representing industries. Matches if company operates in any of the listed industries. Takes specific values available in the LinkedIn interface.
Sales Navigator filter configuration
sizes(optional) – array of enums representing employee count ranges. Matches if company’s size falls within any of the listed ranges. Options:1-10.11-50.51-200.201-500.501-1000.1001-5000.5001-10000.10001+.
locations(optional) – array of free-form strings representing locations. Matches if company is headquartered in any of the listed locations.industries(optional) – array of enums representing industries. Matches if company operates in any of the listed industries. Takes specific values available in the LinkedIn interface.annualRevenue(optional) – object representing company annual revenue range in million USD:min– enum with options:0.0.5.1.2.5.5.10.20.50.100.500.1000.
max– enum with options:
0.5.1.2.5.5.10.20.50.100.500.1000.1000+.
When multiple filter fields are specified, they are combined using
AND logic.Response
- If you selected
standardindataSource:
{
"status": "complete",
"completion": [
{
"searchId": "unique-id-1",
"result": {
"success": true,
"data": [
{
"name": "TechCorp",
"publicUrl": "https://www.linkedin.com/company/techcorp",
"industry": "Information Technology",
"location": "California",
"include": {
"basicInfo": { ... }
}
},
{
"name": "Techical Life",
"publicUrl": "https://www.linkedin.com/company/techlife",
"industry": "Software Development",
"location": "Mountain View",
"include": {
"basicInfo": { ... }
}
}
]
}
},
{
"searchId": "unique-id-2",
"result": {
"success": true,
"data": [
{
"name": "EcoPower",
"publicUrl": "https://www.linkedin.com/company/ecopower",
"industry": "Services for Renewable Energy",
"location": "Cupertino, California",
"include": null
},
{
"name": "GreenFlow",
"publicUrl": "https://www.linkedin.com/company/greenflow",
"industry": "Professional Services",
"location": "Menlo Park, CA",
"include": null
}
]
}
}
]
}
name– name of the company.publicUrl– public LinkedIn URL of the company.industry– enum representing the company industry. Takes specific values available in the LinkedIn interface.location– free-form string representing the company headquarters location.include–nullor additional data retrieved using the include object.
- If you selected
salesNavigatorindataSource:
{
"status": "complete",
"completion": [
{
"searchId": "unique-id-1",
"result": {
"success": true,
"data": [
{
"name": "TechCorp",
"hashedUrl": "https://www.linkedin.com/company/12345678",
"industry": "Information Technology",
"employeeCount": 500,
"include": {
"basicInfo": { ... }
}
},
{
"name": "Techical Life",
"hashedUrl": "https://www.linkedin.com/company/87654321",
"industry": "Software Development",
"employeeCount": 120,
"include": {
"basicInfo": { ... }
}
}
]
}
},
{
"searchId": "unique-id-2",
"result": {
"success": true,
"data": [
{
"name": "EcoPower",
"hashedUrl": "https://www.linkedin.com/company/44771122",
"industry": "Services for Renewable Energy",
"employeeCount": 100,
"include": null
},
{
"name": "GreenFlow",
"hashedUrl": "https://www.linkedin.com/company/87654321",
"industry": "Professional Services",
"employeeCount": 55,
"include": null
}
]
}
}
]
}
name– name of the company.hashedUrl– hashed LinkedIn URL of the company.industry– enum representing the company industry. Takes specific values available in the LinkedIn interface.employeeCount– total number of employees associated with the company.include–nullor additional data retrieved using the include object.
- If some searches are unsuccessful:
{
"status": "complete",
"completion": [
{
"searchId": "unique-id-1",
"result": {
"success": false,
"error": {
"errorType": "searchingNotAllowed",
"message": "LinkedIn has blocked performing the search."
}
}
},
{
"searchId": "unique-id-2",
"result": {
"success": true,
"data": [
{
"name": "EcoPower",
"hashedUrl": "https://www.linkedin.com/company/44771122",
"industry": "Services for Renewable Energy",
"employeeCount": 100,
"include": null
},
{
"name": "GreenFlow",
"hashedUrl": "https://www.linkedin.com/company/87654321",
"industry": "Professional Services",
"employeeCount": 55,
"include": null
}
]
}
}
]
}
errorType– enum with the following possible values:searchingNotAllowed– LinkedIn has blocked performing the search due to exceeding limits or other restrictions.
Throughout the documentation, for simplicity, only the request body and final response (when status is
complete) are shown. Consider possible global errors and result handling options for proper implementation.