Discover contacts grouped by domain

Changed on

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

  • Base URL
    https://api.discolike.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

filter_industrystring[] nullable

Filter by industry category (ANY-OF; prefix + to require a 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, EUROPE, ASIA, AFRICA, NORTH_AMERICA, SOUTH_AMERICA, OCEANIA, ANTARCTICA.

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. Accepts ISO 3166-2 codes or names, listed at https://docs.discolike.com/states/, resolved against the selected countries; a value that resolves under none is ignored.

negate_filter_statestring[] nullable

Exclude contacts at companies in specified states. Same format as filter_state.

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

Accepted and ignored. Contacts are no longer indexed by skills.

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

Matched against the job title: a contact matches when its title matches any one term. Unquoted words are separate terms; a quoted term is a phrase (adjacent, in order); prefix + to require a term.

negate_summarystring nullable

Exclude contacts whose job title matches any one term. Unquoted words are separate terms; a quoted term is a phrase (adjacent, in order).

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, EUROPE, ASIA, AFRICA, NORTH_AMERICA, SOUTH_AMERICA, OCEANIA, ANTARCTICA.

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. Accepts ISO 3166-2 codes or names, listed at https://docs.discolike.com/states/, resolved against the selected countries; a value that resolves under none is ignored.

has_emailboolean

Only include contacts with email addresses.

email_validatedboolean

Deprecated: treated as has_email. Results are not pre-verified; run email verification instead.

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.

Changes

    • breaking

      removed the enum value ACCOUNTING of the request property //

    • breaking

      removed the enum value ADVERTISING_AND_MARKETING of the request property //

    • breaking

      removed the enum value AGRICULTURE_AND_NATURAL_RESOURCES of the request property //

    • breaking

      removed the enum value ALCOHOL_AND_TOBACCO of the request property //

    • breaking

      removed the enum value AUTOMOTIVE of the request property //

    • breaking

      removed the enum value BIG_DATA_AND_ANALYTICS of the request property //

    • breaking

      removed the enum value BIOTECHNOLOGY of the request property //

    • breaking

      removed the enum value BLOCKCHAIN_AND_CRYPTOCURRENCY of the request property //

    • breaking

      removed the enum value BUSINESS_PRODUCTS_AND_SERVICES of the request property //

    • breaking

      removed the enum value CLOUD_COMPUTING of the request property //

    • breaking

      removed the enum value COMPUTER_HARDWARE_AND_SEMICONDUCTORS of the request property //

    • breaking

      removed the enum value CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES of the request property //

    • breaking

      removed the enum value CONSTRUCTION of the request property //

    • breaking

      removed the enum value CONSUMER_PRODUCTS of the request property //

    • breaking

      removed the enum value CONSUMER_SERVICES of the request property //

    • breaking

      removed the enum value CYBERSECURITY of the request property //

    • breaking

      removed the enum value DEFENSE_AND_AEROSPACE of the request property //

    • breaking

      removed the enum value E-COMMERCE of the request property //

    • breaking

      removed the enum value EDUCATION of the request property //

    • breaking

      removed the enum value ENERGY of the request property //

    • breaking

      removed the enum value ENGINEERING of the request property //

    • breaking

      removed the enum value ENTERTAINMENT of the request property //

    • breaking

      removed the enum value ENVIRONMENTAL_SERVICES of the request property //

    • breaking

      removed the enum value FASHION_TEXTILE_AND_APPAREL of the request property //

    • breaking

      removed the enum value FINANCIAL_SERVICES of the request property //

    • breaking

      removed the enum value FOOD_AND_BEVERAGE of the request property //

    • breaking

      removed the enum value GAMING_AND_ESPORTS of the request property //

    • breaking

      removed the enum value GOVERNMENT_SERVICES of the request property //

    • breaking

      removed the enum value HEALTHCARE of the request property //

    • breaking

      removed the enum value HOSPITALITY of the request property //

    • breaking

      removed the enum value HUMAN_RESOURCES of the request property //

    • breaking

      removed the enum value INSURANCE of the request property //

    • breaking

      removed the enum value IT_SERVICES of the request property //

    • breaking

      removed the enum value LEGAL of the request property //

    • breaking

      removed the enum value MANUFACTURING of the request property //

    • breaking

      removed the enum value MEDIA of the request property //

    • breaking

      removed the enum value MINING_AND_METALS of the request property //

    • breaking

      removed the enum value NONPROFIT_AND_PHILANTHROPY of the request property //

    • breaking

      removed the enum value OIL_AND_GAS of the request property //

    • breaking

      removed the enum value PHARMACEUTICALS of the request property //

    • breaking

      removed the enum value PRIVATE_EQUITY_AND_VENTURE_CAPITAL of the request property //

    • breaking

      removed the enum value REAL_ESTATE of the request property //

    • breaking

      removed the enum value RENEWABLE_ENERGY of the request property //

    • breaking

      removed the enum value RESTAURANTS of the request property //

    • breaking

      removed the enum value RETAIL of the request property //

    • breaking

      removed the enum value SAAS of the request property //

    • breaking

      removed the enum value SECURITY of the request property //

    • breaking

      removed the enum value SOFTWARE of the request property //

    • breaking

      removed the enum value SPORTS_AND_RECREATION of the request property //

    • breaking

      removed the enum value SUPPLY_CHAIN_AND_PROCUREMENT of the request property //

    • breaking

      removed the enum value TELECOMMUNICATIONS of the request property //

    • breaking

      removed the enum value TRAVEL of the request property //

    • breaking

      removed the enum value WELLNESS_AND_LIFESTYLE of the request property //

    • info

      endpoint deprecated

    • info

      the request property default value changed from 100 to 500

    • info

      request property deprecated