nace_code) + scope (country) · a breakdown dimension (group_by). Returns: exact counts per bucket.
POST /v2/stats answers “how many” and “distribution of” with exact, deterministic counts, unlike search, which scores and ranks. Use it for market sizing, territory planning, and coverage checks.
The recipe
SetISTARI_API_KEY, then swap in your filters and group_by dimension. The request maps to POST /v2/stats.
What each lever does
Validated examples
The same tool, three different breakdowns — all exact: German manufacturers (NACE C) by state: Nordrhein-Westfalen 37,627 · Bayern 31,543 · Baden-Württemberg 29,705 · Niedersachsen 13,190 · Hessen 11,675
German manufacturers by organization_size: Small (10–49) 81,270 · Micro (0–9) 62,792 · Medium (50–249) 17,598 · Large (250+) 9,473
Switzerland by nace_code (sector mix): Professional/scientific (N) 53,397 · Wholesale/retail (G) 27,872 · Manufacturing (C) 21,985 · Health (R) 19,996 · Construction (F) 19,874
Notes
- For a product-specific count, there’s no exact tool: deliver the supplier shortlist instead, and quote the aggregate only as a labeled sector denominator.
- Discover valid
summary_keywordstags by runningPOST /v2/statswithgroup_by: "summary_keywords"on a narrow slice rather than guessing.