Get Product Attribute

get_product_attribute resolves a single attribute in the HG Insights product taxonomy by attributeId. It proxies POST /v2/products/attributes/search with filters.attribute_ids: [attributeId] and limit: 1, returning the single matching row (or null when the id is unknown).

For browsing/search, use list_product_attributes.

Parameters

Name	Type	Required	Default	Description
attributeId	int (≥ 0)	Yes	—	Exact attribute_id (Int16).

Required Integrations

• hginsights_v2

Credit Cost

Free — no credits consumed.

Example Usage

{
  "tool": "get_product_attribute",
  "parameters": { "attributeId": 17 }
}

Response Format

{
  "attribute": {
    "attribute_id": 17,
    "attribute_name": "Open Source",
    "attribute_description": null,
    "attribute_parent_id": 0,
    "attribute_level": 1,
    "product_count": 12
  },
  "credits_consumed": 0
}

• attribute is null when the id is unknown.
• attribute_parent_id: 0 indicates a root attribute; attribute_level: 0 indicates the root level.

Error Handling

Cause	Surface
Missing attributeId	Tool-side Zod validation error
HG Insights V2 auth failure	UpstreamApiError 401/403 with a helpful auth message

Related Tools

• list_product_attributes — browse / search the attribute taxonomy
• get_product_category — single-category lookup
• company_technographic — filter by attribute id