Segmentation

The segmentation module produces and sizes the population of companies that match a firmographic or classification profile. You describe a profile (industry, size, geography, business model, theme), and Search returns the whole set that fits it, plus the count. That count is your market size.

Who uses it: marketing and strategy teams sizing markets (TAM/SAM) and building ICP target lists; data providers and analysts building reproducible company datasets.

Input contract


Requires	at least one filter. An empty query would return the entire company universe, so it's rejected.
Anchor	none. There's no single required filter, just the one-filter minimum.
Allows	all firmographic, classification, and location filters, plus `company_keywords` .
Rejects	identity filters (`company_name`, `company_website`, `veridion_id`; use `company_lookup` or `company_verification`) and `company_products` (use `supplier_discovery`).

Behavior

Search gates by the profile and returns distinct companies. If you include a text filter (company_keywords), results are ranked by keyword relevance; otherwise they come back in a deterministic sort.

Output

Each result is a full company profile at the root of the result object. Read result_count for the market size. To pull the list itself, page through result with next_cursor.

Evidence appears only for keyword matches, so a segmentation built from structured filters alone returns no evidence block. See Response fields and types and Explainability (evidence).

Request

Size the market of mid-market SaaS companies headquartered in the DACH region (strictness: 1, so domiciled there, not merely present), with 50 to 500 employees and at least 10,000,000 in estimated revenue:

{
  "module": "segmentation",
  "query": {
    "and": [
      { "attribute": "company_business_model", "relation": "in", "value": ["Software-as-a-Service"] },
      { "attribute": "company_location", "relation": "in", "value": [{ "country": "DE" }, { "country": "AT" }, { "country": "CH" }], "strictness": 1 },
      { "attribute": "company_employee_count", "relation": "between", "value": [50, 500] },
      { "attribute": "company_estimated_revenue", "relation": "greater_than_or_equal", "value": 10000000 }
    ]
  }
}

company_business_model captures the money-making lever, not the industry: this counts every company that monetizes as SaaS in the region, across sectors. Add an industry or NAICS gate when you want the software sector specifically.

Special scenarios

Domicile vs. presence. Use strictness on company_location to choose whether a company counts because it's headquartered in a place (1, the default), has a non-HQ location there (2), or operates there at all (3). "Companies based in Germany" and "companies operating in Germany" are different populations. See Company location filter.
Regional sizing by radius. Use company_location with within to size a market around a point.
Themed segments. Add company_keywords to narrow a population to a theme (for example "sustainable packaging") and rank by relevance.