People Search

This guide will assist you in integrating the search functionality into your application for querying people data in the ProAPIs datasets of LinkedIn profiles. 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 people 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 people profiles:

• first_name (string)

• last_name (string)

• summary (string)

• sub_title (string)

• location_country (string)

• location_city (string)

• location_state (string)

• influencer (boolean)

• premium (boolean)

• language (string)

• industry (string)

• certifications (list[str])

• degree_names (list[str])

• study_fields (list[str])

• school_names (list[str])

• current_companies (list[int])

• past_companies (list[int])

• current_job_titles (list[str])

• past_job_titles (list[str])

• skills (list[str])

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 first name in the query.

POST /search/hosted/people
{
  "query": "first_name:\"John\""
}

This query searches only the first_name field for the term "John”

Logical Operators

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

POST /search/hosted/people
{
  "query": "location_city:\"new york\" AND industry:\"Human Resources\""
}

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 people located in either "New York" or "San Francisco" that are in the "Computer Software" industry, working for Google and have worked for Microsoft in the past, you can construct a query like this:

POST /search/hosted/people
{
  "query": "(location_city:\"new york\" OR location_city:\"san francisco\") AND industry:\"Computer Software\" AND past_companies: 1035 AND current_companies: 1441"
}

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.