Counts matching firms and breaks them down by one to three dimensions, e.g. how many family offices in Texas by primary domain. Returns the total and, per dimension, the values with their counts (top 40 values). Useful for how many, breakdown, distribution and coverage questions; one call covers what paging through search results would.
View input schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keyword search over firm name, description, city, family name, decision-maker names and research titles."
},
"category": {
"type": "array",
"items": {
"type": "string"
},
"description": "Investor category, exact values: Family office | Venture capital & startup investor | Fund of funds | Principal & permanent capital | RIA. Filters by kind of investor (e.g. \"RIAs\", \"funds of funds\", \"family offices\")."
},
"type": {
"type": "array",
"items": {
"type": "string"
},
"description": "Investor type, exact stored values only; each category has its own list: Family office: Single family office | Multi family office | Family owned holding co | Family led private investment firm | VC/fund run by a family office. Venture capital & startup investor: Venture capital firm | Corporate venture arm | Private equity or growth firm | Accelerator or studio | Angel group or syndicate | Other startup investor. Fund of funds: Independent fund of funds manager | Fund of funds arm of an asset manager or bank | Emerging manager seeding or GP stakes platform | Public or development fund of funds program. Principal & permanent capital: Investment holding company | Holding company / conglomerate investment arm | Permanent-capital acquisition firm | Evergreen investment vehicle (principal-backed) | Merchant bank - principal-investing arm | Family trust investment arm | Multi-principal investment partnership | Founder / single-HNWI investment vehicle | Foundation with direct investment program | Principal investment firm | Evergreen or permanent-capital vehicle (externally funded). RIA: Registered investment adviser."
},
"region": {
"type": "array",
"items": {
"type": "string"
},
"description": "North America | Europe | Middle East | South East Asia | Oceania | East Asia | LATAM | Africa"
},
"country": {
"type": "array",
"items": {
"type": "string"
},
"description": "Country names as stored, e.g. USA, United Kingdom, Switzerland"
},
"state": {
"type": "array",
"items": {
"type": "string"
},
"description": "US state names, e.g. Texas"
},
"city": {
"type": "string"
},
"primary_domain": {
"type": "array",
"items": {
"type": "string"
},
"description": "Primary investment domains are ASSET CLASSES, exact stored values: Private Equity | Real Estate | Startups | Public Equities | Venture Capital | Philanthropy | Private Credit | Impact | Hedge Funds | Energy & Natural Resources | Infrastructure | Art & Collectibles. Industry sectors are stored as secondary domains, not primary domains."
},
"any_domain": {
"type": "array",
"items": {
"type": "string"
},
"description": "Matches primary OR secondary domains; industry sectors are stored here, e.g. Healthcare, Biotech, Digital Health, Medical Devices, Pharmaceuticals, Technology, Industrial, Consumer, Financial Services, Climate, Hospitality, Retail, Manufacturing."
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
},
"maxItems": 12,
"description": "Words and phrases that describe what the person is looking for, beyond the exact tags: synonyms, sub-sectors, related terms, e.g. for healthcare: healthcare, medical, hospital, life sciences, biotech, pharma, medtech, digital health. Matched against firm descriptions, names, cities, family names, decision-maker names and research titles. Works best with 4 to 10 terms when the question names a sector, theme, strategy or any wording that may not be a stored tag."
},
"domain_mode": {
"type": "string",
"enum": [
"tag_or_text",
"tag"
],
"description": "How any_domain and keywords combine. tag_or_text: a firm matches when it has one of the domain tags OR its record mentions a keyword. tag: a firm matches when it has one of the domain tags AND its record mentions a keyword. Default tag_or_text when both any_domain and keywords are present."
},
"stage": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact stored values: Pre-seed/Seed | Early | Growth | Buyout | Lower Middle Market | SMB"
},
"geo_focus": {
"type": "array",
"items": {
"type": "string"
},
"description": "Geographic focus tags"
},
"cause": {
"type": "array",
"items": {
"type": "string"
},
"description": "Philanthropic causes (family offices; principal & permanent-capital firms where stated)"
},
"giant_any": {
"type": "boolean",
"description": "Only billionaire families or 13F filers (family offices only)"
},
"has_work_email": {
"type": "boolean",
"description": "Only firms with at least one work email on a decision-maker"
},
"has_philanthropy": {
"type": "boolean",
"description": "Only firms with philanthropy data (family offices and principal & permanent-capital firms only)"
},
"has_news": {
"type": "boolean",
"description": "Only firms with news on record"
},
"aum_disclosed": {
"type": "boolean",
"description": "Only firms whose AUM is a real value, not a placeholder"
},
"updated_since": {
"type": "string",
"description": "ISO date (YYYY-MM-DD): only firms whose record changed (data_version moved) on or after it"
},
"fof_strategy": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fund of funds only: Primaries | Secondaries | Co-investments | Direct investments | GP stakes or seeding"
},
"emerging_manager_focus": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fund of funds only: Y | N | Unknown"
},
"ppc_type": {
"type": "array",
"items": {
"type": "string"
},
"description": "Principal & permanent capital only: Investment holding company | Holding company / conglomerate investment arm | Permanent-capital acquisition firm | Evergreen investment vehicle (principal-backed) | Merchant bank - principal-investing arm | Family trust investment arm | Multi-principal investment partnership | Founder / single-HNWI investment vehicle | Foundation with direct investment program | Principal investment firm | Evergreen or permanent-capital vehicle (externally funded)"
},
"capital_source": {
"type": "array",
"items": {
"type": "string"
},
"description": "Principal & permanent capital only: Own balance sheet | Principals | Family or founder | Group | Foundation endowment | External, permanent or evergreen mandate"
},
"investment_approach": {
"type": "array",
"items": {
"type": "string"
},
"description": "Principal & permanent capital: Control | Minority | Direct | Fund commitments | Credit | Real assets. RIA: Third-party funds | Direct | Co-invest | SPVs | OCIO mandates"
},
"ria_segment": {
"type": "array",
"items": {
"type": "string"
},
"description": "RIA only: Alts allocator | Gatekeeper | Direct and co-invest | OCIO or consultant | M&A target | M&A acquirer"
},
"ownership": {
"type": "array",
"items": {
"type": "string"
},
"description": "RIA only: Founder-owned | PE-backed | Bank or insurer-owned | Public | Employee-owned"
},
"private_funds": {
"type": "array",
"items": {
"type": "string"
},
"description": "RIA only: Y | N"
},
"group_by": {
"type": "array",
"items": {
"type": "string",
"enum": [
"category",
"type",
"region",
"country",
"state",
"primary_domain",
"secondary_domain",
"any_domain",
"stage",
"cause",
"geo_focus",
"giant",
"team_size",
"philanthropy_confidence",
"has_work_email",
"has_philanthropy",
"has_news",
"aum_disclosed",
"fof_strategy",
"ria_segment",
"ppc_type",
"capital_source",
"investment_approach"
]
},
"maxItems": 3,
"description": "One to three dimensions to break the total down by."
}
}
}