payload.filter_industry | array | No | — | Filter by industry category. Valid values: ACCOUNTING (Professional services related to financial record-keeping, analysis, reporting, auditing, tax, and related advisory/consulting services for businesses and individuals. Includes large multidisciplinary accounting networks and the Big Four (Deloitte, PwC, EY, KPMG), even when they also provide broader consulting services.), ADVERTISING_AND_MARKETING (The creation and execution of promotional strategies for products, services, or brands, See the live schema for the complete constraint. |
payload.negate_filter_industry | array | No | — | Exclude contacts at companies in specified industries. Valid values: ACCOUNTING (Professional services related to financial record-keeping, analysis, reporting, auditing, tax, and related advisory/consulting services for businesses and individuals. Includes large multidisciplinary accounting networks and the Big Four (Deloitte, PwC, EY, KPMG), even when they also provide broader consulting services.), ADVERTISING_AND_MARKETING (The creation and execution of promotional strategies for products, See the live schema for the complete constraint. |
payload.filter_country | array | No | — | Filter by company country using ISO-3166-1 alpha-2 codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ. |
payload.negate_filter_country | array | No | — | Exclude contacts at companies in specified countries. Accepts same codes and region aliases as filter_country. |
payload.filter_state | array | No | — | Filter by company state/region. |
payload.negate_filter_state | array | No | — | Exclude contacts at companies in specified states. |
payload.employee_range | string | No | — | Filter by employee count range. Format: ‘min,max’ (e.g., ‘51,200’). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. |
payload.revenue_range | string | No | — | — |
payload.seniority | array | No | — | Filter by seniority bucket: executive, vp, director, manager, senior_ic, mid_level, entry_level |
payload.negate_seniority | array | No | — | Exclude contacts with these seniority levels: executive, vp, director, manager, senior_ic, mid_level, entry_level |
payload.department | array | No | — | Filter by department. Valid values: Operations, Executive, Technology, Sales - Marketing, Finance, Legal, Human Resources, Medical - Science, Customer Service, Research & Development, Administration, Public Relations, Investor Relations, Pro Services, Other. |
payload.negate_department | array | No | — | Exclude contacts in specified departments. Same valid values as department. |
payload.skills | array | No | — | Filter by skills. Multiple skills can be provided. |
payload.name | string | No | — | Filter by contact name (partial match supported). |
payload.title | array | No | — | Filter by job title. Each item is a separate match term. Supports quoted phrases and + prefix for required terms. |
payload.negate_title | array | No | — | Exclude contacts with specified job titles. |
payload.summary | string | No | — | Filter by profile summary text (semantic search). |
payload.negate_summary | string | No | — | Exclude contacts matching this summary description. |
payload.person_country | array | No | — | Filter by contact’s country using ISO-3166-1 alpha-2 codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ. |
payload.negate_person_country | array | No | — | Exclude contacts in specified countries. Accepts same codes and region aliases as person_country. |
payload.person_state | array | No | — | Filter by contact’s state/region. |
payload.has_email | boolean | No | false | Only include contacts with email addresses. |
payload.email_validated | boolean | No | false | Only include contacts with validated email addresses. |
payload.has_phone | boolean | No | false | Only include contacts with phone numbers. |
payload.has_mobile | boolean | No | false | Only include contacts with mobile phone numbers. |
payload.has_linkedin | boolean | No | false | Only include contacts with LinkedIn profiles. |
payload.min_connections | integer | No | — | Minimum LinkedIn connections required. Minimum: 0. |
payload.persona_id | array | No | — | Filter by specific persona IDs. |
payload.icp_text | string | No | — | Natural language description of ideal contact profile for semantic matching. Maximum length: 4000. |
payload.negate_icp_text | string | No | — | Exclude contacts matching this profile description. Maximum length: 4000. |
payload.icp_prompt | string | No | — | Natural language ICP description. Automatically extracts structured contact filters (seniority, department, industry, country, employee/revenue range, etc.), cleans the semantic description, and applies them before running the contact search. User-provided filters take precedence over wizard-extracted ones. Maximum length: 4000. |
payload.domain | array | No | — | Filter contacts at specific company domains. |
payload.inclusion_query_id | array | No | — | Include only contacts from companies in these saved queries. |
payload.exclusion_query_id | array | No | — | Exclude contacts from companies in these saved queries. |
payload.max_records | integer | No | 100 | Maximum number of contacts to return (20-10000). Minimum: 20. Maximum: 10000. |
payload.max_companies | integer | No | — | Maximum number of enriched companies to return. Cannot be combined with max_records; when set, the internal total contact cap is derived from max_companies * results_by_company, capped at 10000. Minimum: 1. Maximum: 10000. |
payload.offset | integer | No | 0 | Number of results to skip for pagination. Minimum: 0. Maximum: 10000. |
payload.results_by_company | integer | No | 5 | Maximum contacts per company domain. Default 5 — i.e. without this parameter the endpoint returns up to 5 contacts from any one company so results spread across more distinct companies. Set results_by_company=0 to remove the cap (return every matching contact per company, up to max_records total — or the global ceiling of 10000 when paired with max_companies). When the value is non-zero, offset is forced to 0 (pagination is disabled). Minimum: 0. Maximum: 100. |
payload.include_search_contacts | boolean | No | false | Include contacts from the search index (broader coverage). |
payload.consensus | integer | No | 1 | Number of query vectors to combine for consensus search. Minimum: 1. Maximum: 20. |