Count matching businesses

Changed on

Estimate the number of matching business profiles based on search criteria.

get/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

phrase_matchstring[] nullable

Exact text fragments to search for in site content. Up to 20 fragments, each at least 3 characters. Any one plain fragment matches; prefix + to require one, and +a|b requires any one of a, b.

negate_phrase_matchstring[] nullable

Exact text fragments to exclude from results. Up to 20 fragments, each at least 3 characters.

subdomainstring[] nullable

Limit results to specified subdomains. Up to 20, each at least 3 characters.

negate_subdomainstring[] nullable

Exclude specified subdomains from results. Up to 20, each at least 3 characters.

tech_stackstring[] nullable

Filter to companies using specified vendor domains (up to 20).

negate_tech_stackstring[] nullable

Exclude companies using specified vendor domains (up to 20).

categorystring[] 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_categorystring[] nullable

Exclude specified industry categories. 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.

sub_industrystring[] nullable

Filter by sub-industry, a second-level label scoped to an industry category. Accepts a bare label (ROOFING) or a parent-qualified key (CONSTRUCTION/ROOFING), case-insensitive, up to 50 values, normalized to the qualified key. A bare label adds its parent to the category filter. A category with one of its sub-industries selected is narrowed to them; any other selected category stays whole, so category=SAAS,CONSTRUCTION with sub_industry=HOME_BUILDER returns SaaS companies and home builders.

negate_sub_industrystring[] nullable

Exclude specified sub-industries. Same format as sub_industry; does not affect the category filter.

latnumber nullable

Latitude of the search centre. Must be supplied together with lon.

lonnumber nullable

Longitude of the search centre. Must be supplied together with lat.

radiusstring nullable

Search radius around lat/lon: a number optionally suffixed with km or mi (50km, 30mi, 50). A bare number is kilometres. Defaults to 50km when lat/lon are supplied, maximum 1000km.

geostring[] nullable

A circular area to search, written lat,lon or lat,lon,radius (30.27,-97.74 or 30.27,-97.74,30mi). The radius is a number optionally suffixed with km or mi, a bare number meaning kilometres; it defaults to 50km and may not exceed 1000km. Repeatable: every geo circle, every bbox and the lat/lon/radius centre are OR'd together, up to 10 shapes in total.

bboxstring[] nullable

Bounding box as min_lat,min_lon,max_lat,max_lon. Longitudes may wrap the antimeridian (min_lon above max_lon). Repeatable: every geo circle, every bbox and the lat/lon/radius centre are OR'd together, up to 10 shapes in total.

min_digital_footprintinteger nullable

Minimum digital footprint score (0-800). Default 25.

max_digital_footprintinteger nullable

Maximum digital footprint score (0-800). Default 800.

statestring[] nullable

Filter by ISO 3166-2 state codes or names (up to 100), listed at https://docs.discolike.com/states/. Requires exactly one country value, which may be a region alias; the state is then resolved against every country the alias covers. A value that resolves under none is rejected.

negate_statestring[] nullable

Exclude specified states from results (up to 100). Same format and country rules as state.

countrystring[] nullable

ISO-3166-1 alpha-2 country codes (e.g., US, GB, DE) or region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ, EUROPE, ASIA, AFRICA, NORTH_AMERICA, SOUTH_AMERICA, OCEANIA, ANTARCTICA.

negate_countrystring[] nullable

Exclude specified countries from results. Accepts same codes and region aliases as country.

start_datestring nullable

Minimum company start date (YYYY-MM-DD) or range (YYYY-MM-DD,YYYY-MM-DD).

redirectboolean

Include domains that redirect to another domain.

socialstring[] nullable

Filter by social platform presence. Valid values: facebook, instagram, linkedin, pinterest, threads, tiktok, twitter, x, yelp, youtube, googleplay, applestore, amazon, vk, bluesky, xing. Note: 'twitter' is an alias for 'x'.

negate_socialstring[] nullable

Exclude companies with specified social profiles. Filter by social platform presence. Valid values: facebook, instagram, linkedin, pinterest, threads, tiktok, twitter, x, yelp, youtube, googleplay, applestore, amazon, vk, bluesky, xing. Note: 'twitter' is an alias for 'x'.

languagestring[] nullable

Filter by site language. Valid values: af (Afrikaans), ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), bs (Bosnian), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), eo (Esperanto), es (Spanish), et (Estonian), eu (Basque), fa (Persian), fi (Finnish), fr (French), ga (Irish), gl (Galician), he (Hebrew), hi (Hindi), hr (Croatian), hu (Hungarian), hy (Armenian), id (Indonesian), is (Icelandic), it (Italian), ja (Japanese), ka (Georgian), ko (Korean), ky (Kyrgyz), lb (Luxembourgish), lt (Lithuanian), lv (Latvian), mk (Macedonian), ms (Malay), my (Burmese), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sr (Serbian), sv (Swedish), sw (Swahili), th (Thai), tl (Tagalog), tr (Turkish), uk (Ukrainian), ur (Urdu), vi (Vietnamese), zh (Chinese (Simplified)), zt (Chinese (Traditional)).

negate_languagestring[] nullable

Exclude specified languages from results. Filter by site language. Valid values: af (Afrikaans), ar (Arabic), az (Azerbaijani), bg (Bulgarian), bn (Bengali), bs (Bosnian), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), eo (Esperanto), es (Spanish), et (Estonian), eu (Basque), fa (Persian), fi (Finnish), fr (French), ga (Irish), gl (Galician), he (Hebrew), hi (Hindi), hr (Croatian), hu (Hungarian), hy (Armenian), id (Indonesian), is (Icelandic), it (Italian), ja (Japanese), ka (Georgian), ko (Korean), ky (Kyrgyz), lb (Luxembourgish), lt (Lithuanian), lv (Latvian), mk (Macedonian), ms (Malay), my (Burmese), nb (Norwegian Bokmål), nl (Dutch), pb (Portuguese (Brazilian)), pl (Polish), pt (Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sl (Slovenian), sq (Albanian), sr (Serbian), sv (Swedish), sw (Swahili), th (Thai), tl (Tagalog), tr (Turkish), uk (Ukrainian), ur (Urdu), vi (Vietnamese), zh (Chinese (Simplified)), zt (Chinese (Traditional)).

employee_rangestring nullable

Filter by employee count range. Format: 'min,max' (e.g., '1,5000'). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

revenue_rangestring nullable

Filter by company revenue. Format: 'min,max' in raw numbers (e.g., '1000000,10000000' for 1M-10M). Maps to buckets: <1M, 1-10M, 10-100M, 100M-1B, >1B. Unknown-revenue domains (N/A) are included when the range covers the <1M bucket.

business_modelstring[] nullable

Filter by business model label. Multi-select with OR semantics. Valid values: B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B.

negate_business_modelstring[] nullable

Exclude domains with these business model labels. Filter by business model label. Multi-select with OR semantics. Valid values: B2B, B2C, B2G, G2B, G2C, D2C, C2C, C2B.

valid_mxboolean

Only companies with a mail server.

exclude_leadgenboolean

Exclude suspected lead generation sites. Filters out profiles with score <= 25 that also lack phone, email, and social media presence. Defaults to false for counts so they are not narrower than the filters given.

exact_matchstring[] nullable
negate_exact_matchstring[] nullable
vendorstring[] nullable
negate_vendorstring[] nullable
min_scoreinteger nullable
max_scoreinteger nullable

Response

Successful Response

countinteger required

Number of records matching the query

Changes

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • info

      added the new optional query request parameter valid_mx

    • info

      added the enum value af to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value af to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value hy to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value hy to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value is to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value is to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value ka to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value ka to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the enum value lb to the property anyOf[subschema #1]/items/ of the query request parameter language

    • info

      added the enum value lb to the property anyOf[subschema #1]/items/ of the query request parameter negate_language

    • info

      added the new optional query request parameter bbox

    • info

      added the new optional query request parameter geo

    • info

      added the new optional query request parameter lat

    • info

      added the new optional query request parameter lon

    • info

      added the new optional query request parameter negate_sub_industry

    • info

      added the new optional query request parameter radius

    • info

      added the new optional query request parameter sub_industry