Skip to main content
GET
Search People

Authorizations

Authorization
string
header
required

API key for People API authentication. Include as Bearer token in Authorization header.

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
limit
integer
default:100

Number of results per page (maximum 100)

Required range: 1 <= x <= 100
title
string

Job title or comma-separated list (e.g. CTO,VP of Engineering). Matched with word boundaries via taxonomy/pattern logic — COO will not match Cook or Coordinator, and Assistant to the CEO is excluded from CEO.

function
string

Comma-separated function ids. Accepted values: marketing, sales, engineering, product, design, operations, finance, people, data, customer_success, growth, legal. Unknown values return 400.

seniority
string

Comma-separated seniority ids. Accepted values: founder, c_level, vp, director, head, lead, manager. Unknown values return 400.

country
string

ISO 3166-1 alpha-2 country code or comma-separated list (e.g. US,NL). Matches either the company's country or the person's country.

person_countries
string

ISO 3166-1 alpha-2 country code or comma-separated list (e.g. GB,IE). Matches the person's own country only — no company-country fallback, unlike country. Person location is currently available on a minority of records (job-change sourced), so this filter favors precision over recall; combine with country if you need maximum coverage.

exclude_countries
string

Comma-separated list of country codes to EXCLUDE (denylist), e.g. CN. A person is excluded when EITHER their company country or their own person country matches; rows with an unknown country on a side are kept.

city
string

Free-text city match (partial, case-insensitive). Only job-change people carry city data today; employee-sourced people have no city and are excluded when this filter is set.

company_size
string

Comma-separated company size bands, matched against the company's employee count. Accepted values: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1000-plus. People whose record has no linked company with a known headcount are excluded when this filter is set. Unknown values return 400.

industry
string

Industry name or comma-separated list (case-insensitive exact match on the company's industry).

linkedin_url
string

Person LinkedIn profile URL — resolves a specific person instead of browsing an ICP. Matches current employees and job-change subjects by canonical equality; scheme, www. and a trailing slash are accepted and ignored. Must be a personal profile URL (/in/ or legacy /pub/) — pass a company page to company_linkedin_url instead. Invalid syntax returns 400; a valid URL with no match returns an empty data set. When set, signal_date_range defaults to all-time.

company_domain
string

Company website domain — returns the people at that company. Exact (canonicalized) match; scheme, www., port, path and trailing slash are normalized. Invalid syntax returns 400; no match returns an empty data set. When set, signal_date_range defaults to all-time.

company_linkedin_url
string

Company LinkedIn URL — returns the people at that company. Exact (canonicalized) match; scheme, www. and trailing slash are normalized. Invalid syntax returns 400; no match returns an empty data set. When set, signal_date_range defaults to all-time.

signal_type
string

Comma-separated signal type(s) to pin matched_signal to. Accepted values: funding_round, acquisition, job_change. When omitted, matched_signal is the person's newest qualifying signal of any supported type, so types can mix across a page. Unknown values return 400.

signal_date_range
string
default:12m

Lookback window for the matched signal, as <n><unit> where unit is d (days), w (weeks), m (months), or y (years) — e.g. 30d, 6m, 12m, 2y. People whose latest matching signal falls outside this window are excluded. Malformed or out-of-range values return 400. Default: 12m for a normal ICP browse, but all-time when an identifier lookup (linkedin_url, company_domain, or company_linkedin_url) is set — pass an explicit value to still narrow the window.

include_former
enum<string>
default:false

Whether to include former employees. Currently only false is supported — passing true returns 400 because job-change records have no current/former semantics yet. The endpoint is active-only (current employees).

Available options:
false
count
enum<string>

If set to true, returns only the total count without data rows and without deducting credits.

Available options:
true

Response

Successful response with people

success
boolean
required

Indicates if the request was successful

Example:

true

data
object[]
required

Array of matched people

pagination
object
required
meta
object
required