Company Search

This guide will assist you in integrating the search functionality into your application for querying company data in the ProAPIs datasets of LinkedIn companies. You can perform both simple searches and more advanced queries using Lucene syntax.

This document serves as a guide to help you understand and integrate the search functionality for company data within the ProAPIs datasets. It provides examples and explanations to get you started with basic and advanced searches. For API documentation, including endpoints, parameters, and response formats, please check the API docs here.

Searchable Fields

You can query the following fields related to companies:

• name

• website

• tagline

• type

• postal_code

• description

• industries

• location_country

• location_city

• specialities

• followers

• staff_count

Basic Search

To perform a basic search, submit a query string that will be searched across all the fields listed above. The API will return results that contain the search term in any of these fields.

Advanced Search with Lucene Syntax

For more granular searches, you can use Lucene syntax to target specific fields, combine multiple conditions, or specify numeric ranges.

Field-Specific Search

You can narrow your search to a specific field by using the field name in the query.

POST /search/hosted/companies
{
  "query": "name:\"Salesforce\""
}

This query searches only the name field for the exact term "Salesforce"

Logical Operators

Use logical operators to combine multiple search conditions, such as searching for companies in a specific city and industry.

POST /search/hosted/companies
{
  "query": "location_city:\"new york\" AND industries:\"Entertainment\""
}

Searching by Numeric Ranges

You can search for companies by specifying numeric ranges for fields like followers and staff_count. This query returns companies where the staff_count is between 10 and 50, inclusive.

POST /search/hosted/companies
{
  "query": "staff_count:[10 TO 50]"
}

The below query returns companies where the followers count is greater than 100.

POST /search/hosted/companies
{
  "query": "staff_count:{100 TO *}"
}

More Complex QueriesCopied!

To perform more complex searches, you can combine multiple conditions using nested AND and OR operators. For example, if you want to find companies located in either "New York" or "San Francisco" that are in the "Computer Software" industry and have more than 100 employees, you can construct a query like this:

POST /search/hosted/companies
{
  "query": "(location_city:\"New York\" OR location_city:\"San Francisco\") AND industries:\"Computer Software\" AND staff_count:{100 TO *}"
}

To maximize the effectiveness of your searches and make the most out of our API, we recommend studying Lucene syntax, which provides powerful tools for crafting precise and complex queries.