Search people using person filters and an optional company query.

Cost: 2 credits per returned person, plus requested paid expansions. Empty results cost one result's base price.

The education expansion adds 1 credit per returned person. Repeating an expansion does not multiply its cost.

Person filters can be combined with a company query to find people whose current companies match. The company query accepts the same filters, semantic query, and lookalike seeds as company search. Company queries that use query, keyword, technology, funding, workforce, reportedEmployees, or required-feature filters, or a semantic or lookalike query, match people at the 1,000 best-matching companies.

Top-level company, seniority, department, position, and start date filters match current experiences. Use filter.pastExperience to find people by previous employment. Its inclusion rules must all match the same past experience, and people who still work at an included company are excluded. A past company exclusion removes people with any matching past experience. Past seniority, department, and position filters do not support exclusions.

Send an empty object ({}) to search without filters.

Results use cursor pagination. Omit cursor for the first page and pass a cursor returned by the previous response to continue. Numbered pagination is not supported. Keep the same query when continuing a search. Cursors expire after 30 minutes.

Experiences that matched the search filters are marked with isMatched.

A value filter supports these input forms:

• match one value: "TR"
• match several values: ["TR", "US"]
• configure advanced matching rules: { "in": ["TR"], "notIn": ["US"] }

A single value or array matches any provided value. Use the object form to configure inclusion and exclusion rules together. Exclusions on current-experience fields (company, seniority, department, and position) remove a person when any of their current experiences matches.