Get a count of companies matching your search criteria before running a full Discover query. Use this to preview result volume and refine filters before committing to a full search.
ISO-3166-1 alpha-2 country codes (e.g., US, GB, DE). Also accepts region codes that auto-expand to member countries: ANZ, APAC, ASEAN, BENELUX, CEE, DACH, EMEA, EU, GCC, LATAM, MENA, NORDICS.
negate_country
Countries to exclude
state
State/province filter. Accepts ISO 3166-2 codes (e.g. CA, BY) or full names (e.g. California, Bayern). Requires exactly one country value: passing more than one rejects state. That single value may be a region alias (e.g. EU, APAC, DACH), in which case states are resolved against every country the alias expands to. Supported for 120+ countries; see States.
negate_state
States to exclude (same format and country rule as state, up to 100)
geo
Circular search area written lat,lon or lat,lon,radius (e.g. 30.27,-97.74, 30.27,-97.74,30mi). Repeatable: pass it once per circle. 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
bbox
Bounding box written min_lat,min_lon,max_lat,max_lon. Repeatable: pass it once per box. Longitudes may wrap the antimeridian by setting min_lon above max_lon
lat
Latitude of a search centre. Must be supplied together with lon
lon
Longitude of a search centre. Must be supplied together with lat
radius
Search radius around lat/lon: a number optionally suffixed with km or mi (50, 50km, 30mi). A bare number is kilometres. Defaults to 50km, maximum 1000km
Every geo circle, every bbox and the circle formed by lat/lon/radius are OR’d together, up to 10 shapes in total, and the combined area is AND’d with the rest of the filters.
Minimum score (0-800, default: 0 — counts include every score unless you set a floor). Must not exceed max_digital_footprint. Capped at the highest score reachable by a company founded on start_date
max_digital_footprint
Maximum score (0-800, default: 800)
start_date
Company start date (YYYY-MM-DD or range YYYY-MM-DD,YYYY-MM-DD)
Second-level industry label, scoped to a category. Accepts a bare label (ROOFING) or a qualified key (CONSTRUCTION/ROOFING), case-insensitive, up to 50 values. A bare label whose parent is unambiguous adds that parent to category. See Sub-Industries for all 217 values.
negate_sub_industry
Sub-industries to exclude. Same label format, but validated for taxonomy membership only: it never adds to or is checked against category, and a bare label that exists under several categories excludes it under all of them.
employee_range
Employee count range as min,max (e.g., 1,5000). Buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
revenue_range
Company revenue range as min,max in raw integers (e.g., 1000000,10000000). Use + on max for unbounded. Buckets: <1M, 1-10M, 10-100M, 100M-1B, >1B. N/A swept in when range covers <1M
Exclude suspected lead generation sites; filters out low-score profiles that also lack phone, email, and social media presence (default: false — unlike Discover, counts include them unless you opt in)
Count applies the same limits as Discover for the parameters it shares; see the Discover validation table. Malformed employee_range or revenue_range values are silently dropped rather than rejected.
