Search for business contacts using similarity matching, domain filtering, or persona filters. Supports ICP text matching and persona-based similarity search.

get/contacts

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

Query parameters

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

persona_idinteger required

Unique identifier for the contact/persona

domainstring required

Company domain where contact works

namestring nullable

Contact's full name

titlestring nullable

Contact's job title

departmentstring nullable

Contact's department (e.g., Sales, Marketing, Engineering)

seniority'executive' | 'vp' | 'director' | 'manager' | 'senior_ic' | 'mid_level' | 'entry_level' nullable

Seniority bucket: executive, vp, director, manager, senior_ic, mid_level, entry_level. Same vocabulary as the seniority filter parameter.

skillsstring[] nullable

Array of skills attributed to the contact

emailstring nullable

Contact's email address

email_validatedboolean nullable

Result of an email verification run on this contact: true if the address was verified, false if the check failed, null if it has not been verified. Contact search never sets it.

social_urlsstring[] nullable

Social media URLs (linkedin, twitter, etc.)

connectionsinteger nullable

LinkedIn connections count

countrystring nullable

Contact's country code (ISO-3166-1 alpha-2)

statestring nullable

Contact's state/region

industrystring[] nullable

Array of company industries (from BizData)

employees'1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+' nullable

Company size bucket (output only). To filter, use employee_range with 'min,max' format (e.g., '51,200')

revenue_range'<1M' | '1-10M' | '10-100M' | '100M-1B' | '>1B' | 'N/A' nullable

Company revenue bucket (output only). To filter, use revenue_range with 'min,max' in raw numbers (e.g., '1000000,5000000' for 1M-5M)

jobstart_datestring nullable

Date the contact started their current role (YYYY-MM-DD), when known. Filterable via the jobstart_date parameter.

similarityinteger nullable

Similarity score between contact and search query (0-100 scale)

summarystring nullable

Contact's profile summary/bio

company_namestring nullable

Name of the company where contact works

Changes

    • breaking

      for the query request parameter max_records, default value was changed from 100 to 500

    • breaking

      removed the enum value ACCOUNTING from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value ADVERTISING_AND_MARKETING from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value AGRICULTURE_AND_NATURAL_RESOURCES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value ALCOHOL_AND_TOBACCO from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value AUTOMOTIVE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value BIG_DATA_AND_ANALYTICS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value BIOTECHNOLOGY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value BLOCKCHAIN_AND_CRYPTOCURRENCY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value BUSINESS_PRODUCTS_AND_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value CLOUD_COMPUTING from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value COMPUTER_HARDWARE_AND_SEMICONDUCTORS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value CONGLOMERATES_SHELL_AND_HOLDING_COMPANIES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value CONSTRUCTION from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value CONSUMER_PRODUCTS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value CONSUMER_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value CYBERSECURITY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value DEFENSE_AND_AEROSPACE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value E-COMMERCE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value EDUCATION from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value ENERGY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value ENGINEERING from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value ENTERTAINMENT from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value ENVIRONMENTAL_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value FASHION_TEXTILE_AND_APPAREL from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value FINANCIAL_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value FOOD_AND_BEVERAGE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value GAMING_AND_ESPORTS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value GOVERNMENT_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value HEALTHCARE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value HOSPITALITY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value HUMAN_RESOURCES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value INSURANCE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value IT_SERVICES from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value LEGAL from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value MANUFACTURING from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value MEDIA from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value MINING_AND_METALS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value NONPROFIT_AND_PHILANTHROPY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value OIL_AND_GAS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value PHARMACEUTICALS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value PRIVATE_EQUITY_AND_VENTURE_CAPITAL from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value REAL_ESTATE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value RENEWABLE_ENERGY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value RESTAURANTS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value RETAIL from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value SAAS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value SECURITY from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value SOFTWARE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value SPORTS_AND_RECREATION from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value SUPPLY_CHAIN_AND_PROCUREMENT from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value TELECOMMUNICATIONS from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value TRAVEL from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • breaking

      removed the enum value WELLNESS_AND_LIFESTYLE from the property anyOf[subschema #1]/items/ of the query request parameter filter_industry

    • info

      endpoint deprecated

    • info

      endpoint added