Count matching contacts

Changed on

Estimate the number of contacts matching the specified filters.

get/contacts/count

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

countinteger required

Number of records matching the query

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 added