v3

latestOpenAPI 3.1.02026-08-045365213.8 KB

Discover contacts grouped by domain

Search for business contacts and return them grouped by company domain, with firmographic data included per company. Bills net-new contacts and net-new firmo domains.

post/contacts/discover

Request body

filter_industrystring[] nullable

Filter by industry category. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, ENGINEERING, ENTERTAINMENT, ENVIRONMENTAL_SERVICES, FASHION_TEXTILE_AND_APPAREL, FINANCIAL_SERVICES, FOOD_AND_BEVERAGE, GAMING_AND_ESPORTS, GOVERNMENT_SERVICES, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, IT_SERVICES, LEGAL, MANUFACTURING, MEDIA, MINING_AND_METALS, NONPROFIT_AND_PHILANTHROPY, OIL_AND_GAS, PHARMACEUTICALS, PRIVATE_EQUITY_AND_VENTURE_CAPITAL, REAL_ESTATE, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SAAS, SECURITY, SOFTWARE, SPORTS_AND_RECREATION, SUPPLY_CHAIN_AND_PROCUREMENT, TELECOMMUNICATIONS, TRAVEL, WELLNESS_AND_LIFESTYLE.

negate_filter_industrystring[] nullable

Exclude contacts at companies in specified industries. Valid values: ACCOUNTING, ADVERTISING_AND_MARKETING, AGRICULTURE_AND_NATURAL_RESOURCES, ALCOHOL_AND_TOBACCO, AUTOMOTIVE, BIG_DATA_AND_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN_AND_CRYPTOCURRENCY, BUSINESS_PRODUCTS_AND_SERVICES, CLOUD_COMPUTING, COMPUTER_HARDWARE_AND_SEMICONDUCTORS, CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES, CONSTRUCTION, CONSUMER_PRODUCTS, CONSUMER_SERVICES, CYBERSECURITY, DEFENSE_AND_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, ENGINEERING, ENTERTAINMENT, ENVIRONMENTAL_SERVICES, FASHION_TEXTILE_AND_APPAREL, FINANCIAL_SERVICES, FOOD_AND_BEVERAGE, GAMING_AND_ESPORTS, GOVERNMENT_SERVICES, HEALTHCARE, HOSPITALITY, HUMAN_RESOURCES, INSURANCE, IT_SERVICES, LEGAL, MANUFACTURING, MEDIA, MINING_AND_METALS, NONPROFIT_AND_PHILANTHROPY, OIL_AND_GAS, PHARMACEUTICALS, PRIVATE_EQUITY_AND_VENTURE_CAPITAL, REAL_ESTATE, RENEWABLE_ENERGY, RESTAURANTS, RETAIL, SAAS, SECURITY, SOFTWARE, SPORTS_AND_RECREATION, SUPPLY_CHAIN_AND_PROCUREMENT, TELECOMMUNICATIONS, TRAVEL, WELLNESS_AND_LIFESTYLE.

filter_countrystring[] nullable

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.

negate_filter_countrystring[] nullable

Exclude contacts at companies in specified countries. Accepts same codes and region aliases as filter_country.

filter_statestring[] nullable

Filter by company state/region.

negate_filter_statestring[] nullable

Exclude contacts at companies in specified states.

employee_rangestring nullable

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+.

revenue_rangestring nullable

senioritystring[] nullable

Filter by seniority bucket: executive, vp, director, manager, senior_ic, mid_level, entry_level

negate_senioritystring[] nullable

Exclude contacts with these seniority levels: executive, vp, director, manager, senior_ic, mid_level, entry_level

departmentstring[] nullable

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.

negate_departmentstring[] nullable

Exclude contacts in specified departments. Same valid values as department.

skillsstring[] nullable

Filter by skills. Multiple skills can be provided.

namestring nullable

Filter by contact name (partial match supported).

titlestring[] nullable

Filter by job title. Each item is a separate match term. Supports quoted phrases and + prefix for required terms. C-suite acronyms are auto-expanded to their spelled-out forms and vice versa (e.g. 'CEO' also matches 'Chief Executive Officer'); wrap a term in quotes to match it literally without expansion.

negate_titlestring[] nullable

Exclude contacts with specified job titles. C-suite acronyms are expanded the same way as in 'title'.

summarystring nullable

Filter by profile summary text (semantic search).

negate_summarystring nullable

Exclude contacts matching this summary description.

person_countrystring[] nullable

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.

negate_person_countrystring[] nullable

Exclude contacts in specified countries. Accepts same codes and region aliases as person_country.

person_statestring[] nullable

Filter by contact's state/region.

has_emailboolean

Only include contacts with email addresses.

email_validatedboolean

Only include contacts with validated email addresses.

has_phoneboolean

Only include contacts with phone numbers.

has_mobileboolean

Only include contacts with mobile phone numbers.

has_linkedinboolean

Only include contacts with LinkedIn profiles.

min_connectionsinteger nullable

Minimum LinkedIn connections required.

jobstart_datestring nullable

Filter by job start date: minimum date (YYYY-MM-DD) or range (YYYY-MM-DD,YYYY-MM-DD). Matches contacts who started their current role in this window; contacts without a known start date are excluded.

persona_idinteger[] nullable

Filter by specific persona IDs.

icp_textstring nullable

Natural language description of ideal contact profile for semantic matching.

negate_icp_textstring nullable

Exclude contacts matching this profile description.

icp_promptstring nullable

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.

domainstring[] nullable

Filter contacts at specific company domains.

inclusion_query_idstring[] nullable

Include only contacts from companies in these saved queries.

exclusion_query_idstring[] nullable

Exclude contacts from companies in these saved queries.

max_recordsinteger

Maximum number of contacts to return (20-10000).

max_companiesinteger nullable

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.

offsetinteger

Number of results to skip for pagination.

results_by_companyinteger

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).

include_search_contactsboolean

Include contacts from the search index (broader coverage).

consensusinteger

Number of query vectors to combine for consensus search.

Response

Successful Response

resultsobject required

Map of domain → company firmographics plus nested contacts.

total_contactsinteger required

Total matching contacts across all pages (not just this batch).

total_domainsinteger required

Number of unique domains represented in this batch of results.