Skip to main content
POST
Search people
The People Search endpoint lets you build precise lists of individuals based on role, seniority, skills, location, company attributes, and career history. You can combine multiple filters to narrow down exactly the profiles you are looking for, whether you are targeting new hires, decision-makers, or specific personas. How filters work (AND / OR) If you filter by job titles [“CEO”, “CTO”, “VP Sales”] and locations [“France”, “United States”], the API returns results where the job title is any of CEO, CTO, or VP Sales, AND the location is either France or United States. In other words, a result must satisfy at least one value in every filter category you specify. Within a category, values act as OR: a result matches if it fits any of the values. Across categories, the logic is AND: a result must match all categories to be returned. Once you’re ready, pick the relevant endpoint, define your filters, and send a POST request to start searching. If you already know exactly who you want to retrieve, you can also search for a specific person using their professional network URL, which is the most reliable way to match a single individual. Search API pricing For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.)

Predefined Filter Values

For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.)

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
offset
integer

Number of people to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead.

Example:

0

​
limit
integer

Number of people to return (default: 10, max: 100)

Example:

20

​
search_after
string

Cursor-based pagination. Pass the search_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit. The search_after token does not have any expiration date. However, when the database is updated (every month), if the position of a contact changes, the same search_after token might display different results.

Example:

"WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="

​
current_company_names
object[]

Filter by current company names. Use exact_match for precise company name matching.

Example:
​
current_company_domains
object[]

Filter by current company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended for domains.

Example:
​
current_company_professional_network_ids
object[]

Filter by current company professional network IDs.

Example:
​
current_company_professional_network_urls
object[]

Filter by current company professional network URLs.

Example:
​
current_company_specialties
object[]

Filter by current company specialties.

Example:
​
current_company_industries
object[]

Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing'). See Industries for the full list.

Example:
​
past_company_names
object[]

Filter by past company names. Useful for finding people with specific work history.

Example:
​
past_company_domains
object[]

Filter by past company domains

Example:
​
current_company_types
object[]

Filter by company types (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency'). See Company Types for the full list.

Example:
​
current_company_headquarters
object[]

Filter by company headquarters locations (city names, regions, or countries)

Example:
​
current_company_headcounts
object[]

Filter by company size (number of employees). Use ranges to target specific company sizes.

Example:
​
current_company_founded_years
object[]

Filter by company founding year. Useful for targeting startups or established companies.

Example:
​
current_company_ids
object[]

Filter by specific company IDs

​
person_ids
object[]

Filter by specific person IDs

​
person_names
object[]

Filter by person names (first name, last name, or full name)

Example:
​
person_professional_network_ids
object[]

Filter by person professional network IDs.

Example:
​
person_professional_network_urls
object[]

Filter by person professional network URLs.

Example:
​
person_locations
object[]

Filter by person locations (city, region, or country)

Example:
​
person_languages
object[]

Filter by languages spoken by the person

Example:
​
person_skills
object[]

Filter by skills (e.g., 'JavaScript', 'Python', 'Project Management')

Example:
​
current_position_seniority_level
object[]

Filter by person seniority levels (e.g., 'Owner', 'Founder', 'C-level', 'Partner', 'VP', 'Head', 'Director', 'Senior', 'Manager'). See Seniority Levels for the full list.

Example:
​
current_position_job_functions
object[]

Filter by current job functions (e.g., 'Administrative', 'Agriculture & Environment', 'Construction & Trades', ...). See Functions & Subfunctions for the full list.

Example:
​
current_position_sub_functions
object[]

Filter by current sub functions (e.g., 'Data Entry', 'Agriculture/Landscaping', 'Carpenter'). See Functions & Subfunctions for the full list.

Example:
​
current_position_titles
object[]

Filter by current job titles (e.g., 'Software Engineer', 'Product Manager', 'CEO')

Example:
​
past_position_titles
object[]

Filter by past job titles. Useful for finding people who held specific roles.

Example:
​
current_position_years_in
object[]

Filter by years spent in current position. Useful for targeting people new in role or experienced.

Example:
​
current_company_years_at
object[]

Filter by years at current company (tenure). Useful for targeting new hires or long-term employees.

Example:
​
person_universities
object[]

Filter by universities attended (e.g., 'Stanford University', 'MIT', 'Harvard')

Example:
​
current_company_days_since_last_job_change
object[]

Filter by days since last job change. Useful for finding people who recently changed jobs.

Example:

Response

OK

​
people
object[]

Array of people matching the search criteria. Returns empty array if no results found.

​
metadata
object