Skip to main content

Company FAI (Functional Area Intelligence)

Retrieve functional area intelligence about how specific products are used within company departments.

Parameters​

NameTypeRequiredDefaultDescription
companyDomainstring⚠️ Either this or hg_id-The company domain to analyze (e.g., "example.com"). Do not include protocol.
hg_idstring⚠️ Either this or companyDomain-HG Insights company ID (31-32 alphanumeric characters). When provided, takes precedence over companyDomain.
productsstring[]No-Array of product names to analyze via fuzzy matching (e.g., ["snowflake", "microsoft office"]). 1-20 items. Use productIds instead when you have exact IDs.
productIdsnumber[]No-Array of HG Insights numeric product IDs for exact lookup (e.g., [34490, 32955]). 1-20 items. Get these from the productId field in company_technographic results. Takes precedence over products.
providerstringNoautoProvider to use for data lookup.

Required Integrations​

  • hginsights

Important Notes​

  • Preferred: Pass productIds (numeric IDs from company_technographic results) for exact, deterministic lookup.
  • Fallback: Pass product names in products for fuzzy matching.
  • At least one of products or productIds should be provided for meaningful results.

Use Cases​

  • Department-level technology analysis
  • Buying center identification
  • Organizational structure insights
  • Sales territory planning and account mapping

Example Usage​

{
  "tool": "company_fai",
  "parameters": {
    "companyDomain": "cisco.com",
    "productIds": [34490, 32955]
  }
}

Using product names (fuzzy matching)​

{
  "tool": "company_fai",
  "parameters": {
    "companyDomain": "cisco.com",
    "products": ["snowflake", "microsoft office", "salesforce"]
  }
}

Lookup by HG ID​

{
  "tool": "company_fai",
  "parameters": {
    "hg_id": "0FF69D9F596504A1FF4FF5B16FF",
    "products": ["snowflake"]
  }
}

Response Format​

The tool returns a structured JSON response with:

  • data: FAI data showing which departments use each product
  • metadata: Execution metadata including timing and provider information

Error Handling​

Common errors:

  • Missing Integration: HG Insights API key not configured
  • Invalid Parameters: Parameters don't match the schema
  • Rate Limit: API rate limit exceeded
  • Not Found: Company domain not in database
  • company_technographic - Get productId values to use with this tool
  • get_vendor_information - Look up product IDs by vendor name
  • company_firmographic - Company size, industry, location

Next Steps​