Count matching contacts
Changed onEstimate the number of contacts matching the specified filters.
Request
- Base URLhttps://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 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.
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 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.
Exclude contacts at companies in specified countries. Accepts same codes and region aliases as filter_country.
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.
Exclude contacts at companies in specified states. Same format as filter_state.
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+.
Filter by seniority bucket: executive, vp, director, manager, senior_ic, mid_level, entry_level
Exclude contacts with these seniority levels: executive, vp, director, manager, senior_ic, mid_level, entry_level
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.
Exclude contacts in specified departments. Same valid values as department.
Accepted and ignored. Contacts are no longer indexed by skills.
Filter by contact name (partial match supported).
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.
Exclude contacts with specified job titles. C-suite acronyms are expanded the same way as in 'title'.
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.
Exclude contacts whose job title matches any one term. Unquoted words are separate terms; a quoted term is a phrase (adjacent, in order).
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.
Exclude contacts in specified countries. Accepts same codes and region aliases as person_country.
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.
Only include contacts with email addresses.
Deprecated: treated as has_email. Results are not pre-verified; run email verification instead.
Only include contacts with phone numbers.
Only include contacts with mobile phone numbers.
Only include contacts with LinkedIn profiles.
Minimum LinkedIn connections required.
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.
Filter by specific persona IDs.
Natural language description of ideal contact profile for semantic matching.
Exclude contacts matching this profile description.
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.
Filter contacts at specific company domains.
Include only contacts from companies in these saved queries.
Exclude contacts from companies in these saved queries.
Maximum number of contacts to return (20-10000).
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.
Number of results to skip for pagination.
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 contacts from the search index (broader coverage).
Number of query vectors to combine for consensus search.
Response
Successful Response
Changes
- breaking
for the
queryrequest parametermax_records, default value was changed from100to500 - breaking
removed the enum value
ACCOUNTINGfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
ADVERTISING_AND_MARKETINGfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
AGRICULTURE_AND_NATURAL_RESOURCESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
ALCOHOL_AND_TOBACCOfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
AUTOMOTIVEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
BIG_DATA_AND_ANALYTICSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
BIOTECHNOLOGYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
BLOCKCHAIN_AND_CRYPTOCURRENCYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
BUSINESS_PRODUCTS_AND_SERVICESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
CLOUD_COMPUTINGfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
COMPUTER_HARDWARE_AND_SEMICONDUCTORSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
CONGLOMERATES_SHELL_AND_HOLDING_COMPANIESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
CONSTRUCTIONfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
CONSUMER_PRODUCTSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
CONSUMER_SERVICESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
CYBERSECURITYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
DEFENSE_AND_AEROSPACEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
E-COMMERCEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
EDUCATIONfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
ENERGYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
ENGINEERINGfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
ENTERTAINMENTfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
ENVIRONMENTAL_SERVICESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
FASHION_TEXTILE_AND_APPARELfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
FINANCIAL_SERVICESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
FOOD_AND_BEVERAGEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
GAMING_AND_ESPORTSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
GOVERNMENT_SERVICESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
HEALTHCAREfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
HOSPITALITYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
HUMAN_RESOURCESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
INSURANCEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
IT_SERVICESfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
LEGALfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
MANUFACTURINGfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
MEDIAfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
MINING_AND_METALSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
NONPROFIT_AND_PHILANTHROPYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
OIL_AND_GASfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
PHARMACEUTICALSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
PRIVATE_EQUITY_AND_VENTURE_CAPITALfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
REAL_ESTATEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
RENEWABLE_ENERGYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
RESTAURANTSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
RETAILfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
SAASfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
SECURITYfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
SOFTWAREfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
SPORTS_AND_RECREATIONfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
SUPPLY_CHAIN_AND_PROCUREMENTfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
TELECOMMUNICATIONSfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
TRAVELfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry - breaking
removed the enum value
WELLNESS_AND_LIFESTYLEfrom the propertyanyOf[subschema #1]/items/of thequeryrequest parameterfilter_industry
- breaking
- info
endpoint added
- info