Skip to main content
POST
Search people

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Parameters to use for searching people.

person_name
string
person_titles
string[]
person_keywords
string[]

Keywords to search in the person's profile summary (headline, about, etc.). Matches any keyword by default.

person_exclude_keywords
string[]

Keywords to exclude from the person's profile summary.

company_keywords
string[]

Keywords to search in the person's company description. Matches any keyword by default.

company_exclude_keywords
string[]

Keywords to exclude from the person's company description.

person_title_exact_match
boolean
person_seniorities
enum<string>[]
Available options:
Owner,
Founder,
C-Suite,
Partner,
VP,
Head,
Director,
Manager,
Senior,
Entry,
Intern,
Other,
Non-Manager,
Founder / Owner
person_departments
string[]

Available options: Supported departments

person_job_functions
string[]

Available options: Supported job functions

person_locations
string[]
person_exclude_locations
string[]
company_locations
string[]
company_exclude_locations
string[]
company_names
string[]
company_exclude_names
string[]
company_ids
string<uuid>[]
company_exclude_ids
string<uuid>[]
education_company_ids
string<uuid>[]
education_company_names
string[]
company_domains
string<domain>[]
company_exclude_domains
string<domain>[]
company_linkedin_urls
string[]
company_exclude_linkedin_urls
string[]
company_domains_match_subsidiaries_and_affiliates
boolean
company_focuses
enum<string>[]
Available options:
b2b,
b2c
company_types
enum<string>[]
Available options:
Public Company,
Educational,
Self Employed,
Government Agency,
Non Profit,
Self Owned,
Privately Held,
Partnership
company_sizes
enum<string>[]
Available options:
1-10 employees,
11-50 employees,
51-200 employees,
201-500 employees,
501-1000 employees,
1001-5000 employees,
5001-10000 employees,
10001+ employees
company_industries
string[]

Available options: Supported industries

company_exclude_industries
string[]

Available options: Supported industries

linkedin_networks
string[]

Array of user email addresses. The LinkedIn networks of these users will be used for filtering results. Use the special string all_networks to include all LinkedIn networks associated with the account's users.

exclude_linkedin_networks
string[]

Array of user email addresses. The LinkedIn networks of these users will be excluded from the results. Use the special string all_networks to exclude all LinkedIn networks associated with the account's users.

company_investors
string[]

Array of investor names. Filter for companies that have received investment by any of the specified investors.

company_shares_investors_with
string[]

Array of company names. Filter for companies that share one or more common investors with the specified companies.

company_revenue
enum<string>[]

Filter by the person's company estimated revenue range.

Available options:
$0-$1M,
$1M-$10M,
$10M-$100M,
$100M-$1B,
$1B+
company_founded_date
object

Filter by the person's company founding year range.

company_web_traffic_rank
object

Filter by the person's company web traffic rank.

job_openings
object

Filter by the person's company having matching open positions.

news
object

Filter by the person's company having recent news.

headcount_growth
object

Filter by the person's company total headcount growth percentage.

crm_account_owner
string<email>[]

Filter by the person's company CRM account owner emails. Requires a connected CRM integration (Salesforce or HubSpot). Returns an error if no owners match the provided emails.

company_last_funding
object

Filter by the person's company last funding round.

person_linkedin_presence
enum<string>[]

Filter by the person's LinkedIn follower tier. Supported values: influencer — Influencer (10,000+ followers), micro_influencer — Micro Influencer (5,000 - 9,999 followers), large — Large following (500 - 4,999 followers), moderate — Moderate following (100 - 499 followers), limited — Limited following (1 - 99 followers), none — No following (0 followers). All ranges are inclusive.

Available options:
influencer,
large,
limited,
micro_influencer,
moderate,
none
company_linkedin_presence
enum<string>[]

Filter by the person's company LinkedIn follower tier. Supported values: massive — Massive following (100,000+ followers), large — Large following (10,000 - 99,999 followers), moderate — Moderate following (1,000 - 9,999 followers), limited — Limited following (1 - 999 followers), none — No following (0 followers). All ranges are inclusive.

Available options:
large,
limited,
massive,
moderate,
none
page
integer
default:1
page_size
integer
default:5

Number of results per page. Values greater than 100 are accepted and capped at 100.

Required range: x >= 1

Response

Ok

object
enum<string>
required
Available options:
person_search_result
results
object[]
required
_pagination
object
required
_errors
object[]