Get Product Attribute

Resolve HG Insights product-attribute IDs from a search theme. Attributes are the cross-cutting capability tags of the product taxonomy (e.g. 'Cloud Computing', 'Security', 'Software as a Service (SaaS)', 'Open Source') — the semantic layer above individual products. Free — no credits consumed. Search by attributeName for a case-insensitive substring match (relevance-ranked), or pass known attributeIds to fetch specific rows in one call. Provide at least one. Returns rows with attribute_id, attribute_name, attribute_description (a paragraph of context when present; often null for broad root attributes), attribute_parent_id (0 = root), attribute_level (1 = root theme, 2+ = more specific sub-attribute), and product_count (how many products carry the attribute — a rough breadth signal). The taxonomy is hierarchical: a search like 'Cloud' returns both the root 'Cloud Computing' and its children (e.g. 'Cloud Workloads'). Use this when you have a broad capability/theme and need the attribute_id(s) to feed as a filter into product or install tools (e.g. product_search_and_enrich, company_technographic). Do NOT use this to resolve a named product category — use get_product_category for taxonomy categories. Do NOT use this to resolve or look up a vendor/company — use get_vendor_information. It is a taxonomy lookup, not a company data source: it never returns which companies use an attribute.

Parameters

Name	Type	Required	Default	Description
attributeName	string	❌ No	-	Free-text theme to search attribute names by. Case-insensitive substring match on attribute_name and activates relevance ranking. Pass a short capability keyword, not a full product or company name, e.g. 'SaaS', 'Open Source', 'Cloud', 'Security'. A broad term also returns sub-attributes (e.g. 'Cloud' → 'Cloud Computing' and its children).
attributeIds	array	❌ No	-	Fetch specific attributes by their known attribute_ids (from a prior search), returning all matching rows in one call. Use this to re-hydrate ids into names/details; do not guess or enumerate ids sequentially to browse the catalog — search by attributeName instead.
sortBy	string	❌ No	relevance	Sort order for results: 'relevance' (best name match first — only meaningful with attributeName; the default), 'attribute_name' (alphabetical A→Z), or 'product_count' (most-used attributes first, useful for finding the broadest themes).
limit	integer	❌ No	10	Maximum number of attribute rows to return (1–50, default 10). A broad theme can match dozens of attributes; raise this to survey a theme's full sub-hierarchy.
offset	integer	❌ No	0	Zero-based pagination offset (default 0). Combine with limit to page through matches when has_more is true.

Required Integrations

• hginsights_v2

Use Cases

• Find the attribute_id for a capability theme before filtering a product search — e.g. resolve 'SaaS' or 'Security'
• Survey a theme's sub-hierarchy — search a broad term (e.g. 'Cloud') and read the root plus its child attributes
• Rank attributes by breadth — sort by product_count to find the most widely-carried themes
• Re-hydrate known attribute_ids back into names and descriptions in a single call
• Read an attribute's description paragraph to confirm it matches the user's intended capability

Example Usage

Resolve the SaaS attribute by name

{
  "tool": "get_product_attribute",
  "arguments": {
    "attributeName": "SaaS"
  }
}

Survey the Cloud theme, broadest first

{
  "tool": "get_product_attribute",
  "arguments": {
    "attributeName": "Cloud",
    "sortBy": "product_count",
    "limit": 15
  }
}

Re-hydrate specific attribute ids

{
  "tool": "get_product_attribute",
  "arguments": {
    "attributeIds": [
      298,
      891
    ]
  }
}

Related Tools

get_product_category, get_vendor_information, product_search_and_enrich, company_technographic