Search People
search_peopleSearch professional profiles using structured filters.
Instructions
Search professional profiles using structured filters.
Use this for any people search: translate the user's intent (e.g. "AI engineers in Berlin who recently raised") into structured filters on specific columns (country, company size range, funding stage, etc.). The available columns and operators are documented on the filters parameter.
Returns paginated profiles matching ALL/ANY filter conditions depending on the op of the FilterGroup.
To find people at a SPECIFIC company you already identified (e.g. via search_company or enrich_company), filter on current_company_id (or past_company_id) with that company's id (e.g. "org_xxx") — NOT current_company (the name), which also matches other companies that happen to share the name and adds noise.
To target people by their COMPANY's business (e.g. "founders of AI sales-agent startups"), qualify the company itself: filter current_company_category (lowercase, holds precise niche values — "artificial intelligence", "sales automation", "saas") and/or current_company_industry, and when no category fits the niche, current_company_keyword (full-text on the employer's name/tagline/description — OR several "=" phrase variants). keyword searches the PERSON's own headline, so it fits attributes of the person themselves; for a company trait it matches unrelated people ("sales agent" → real-estate agents, sales reps).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of profiles to return (max 100; use offset to paginate further). | |
| offset | No | Pagination offset (number of results to skip). | |
| filters | Yes | Filter group: {"op": "and"|"or", "conditions": [<condition or nested group>, …]}; groups can be nested. Columns — profile: first_name, last_name, profile_location, profile_country, profile_industry, follower_count, keyword (headline full-text) · current job: current_company, current_title, current_job_location, current_company_industry, current_company_category, current_company_size, current_company_id, current_company_keyword (full-text on the employer's name/tagline/description), current_employment_type, years_in_current_position, years_at_current_company, current_company_has_funding, current_company_funding_stage, current_company_investor · past jobs: past_company, past_title, past_job_country, past_company_industry, past_company_size, past_company_id, past_employment_type, years_at_past_company · skills & education: skill, school, degree, degree_level, field_of_study · languages: language, language_iso, language_proficiency · certifications: certification, certification_authority · experience & contact: years_of_experience, num_total_jobs, is_currently_employed, has_email, has_phone. Operators: =, !=, >, >=, <, <=, in, not_in, like, not_like, regex, between, is_null, is_not_null — semantics and per-column value formats are documented on the condition fields of the schema. Example — fintech CEOs/founders in the US or UK: {"op":"and","conditions":[{"op":"or","conditions":[{"column":"current_title","type":"regex","value":"CEO"},{"column":"current_title","type":"like","value":"Founder"}]},{"column":"current_company_category","type":"=","value":"fintech"},{"column":"profile_country","type":"in","value":["US","GB"]}]} | |
| order_by | No | Column to sort by, e.g. "follower_count", "years_of_experience". | |
| enrich_live | No | When true (1.5 credits/profile), each profile is enriched live from LinkedIn so data is fresh. When false (0.75 credits/profile), data is served from the cached database — faster and cheaper. Default is false: live enrichment of many profiles is slow and can time out, so opt in only when freshness matters. | |
| order_direction | No | Sort direction. | desc |
| reveal_personal_email | No | When true, the actual personal_emails array is included on each result (extra credits per email revealed). When false, only the has_personal_email boolean flag is returned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of profiles returned in this page. | |
| error | No | HTTP-style status code, present only when the call failed. | |
| total | No | Total number of matching profiles (estimate). | |
| detail | No | Error message, present only when the call failed. | |
| offset | No | Pagination offset of this page. | |
| results | No | Matching profile objects. | |
| credits_used | No | Credits consumed by this search. | |
| has_next_page | No | Whether more results are available. | |
| total_is_capped | No | True if total reached the 10000 cap. |