Company Install Time Series

Get installation intensity time series data for a company's technology usage over time.

Overview

company_install_time_series returns a monthly intensity time series for each product a company uses, enabling trend analysis over configurable time windows. Each monthly intensity value is an integer from 1 to 31 — the number of days the product was detected that month (null means no detection that month). Use it to answer questions like "How has Cisco's usage of Snowflake changed over the past 2 years?" or "Which cloud products are growing fastest at Microsoft?"

Each product in the response includes:

• current_intensity — a separate aggregate value from global install data; NOT on the 1–31 daily-detection scale, so don't compare it directly to a data_points[].intensity
• intensity_momentum — positive means growing, negative means declining (use this for trend analysis)
• is_active — whether the product was verified within the last 90 days
• data_points — monthly intensity values (integer 1–31 = days detected that month, null if no detection) over the selected time range

Products are ordered by current intensity (descending) when no filters are applied.

Parameters

Name	Type	Required	Default	Description
companyDomain	string	✅ Yes	-	Company domain to look up (no protocol). This tool does not accept hg_id — HG's underlying time-series endpoint is domain-keyed.
products	string[]	No	-	Filter to specific product names (max 50).
productIds	string[]	No	-	Filter by product IDs (max 50).
vendors	string[]	No	-	Filter by vendor name — returns all products from that vendor (max 50).
categories	string[]	No	-	Filter by category name (max 50).
timeRange	enum	No	last_24_months	last_6_months, last_12_months, last_24_months, or last_36_months.
maxProducts	number	No	10	Maximum products to return (1–50).

Required Integrations

• hginsights_v2

Credits

Dynamic: 3 credits per product returned. The actual cost depends on how many products match your filters and the maxProducts cap.

Use Cases

• Tracking technology adoption trends at a target account over time
• Identifying growing or declining products in a company's stack
• Comparing intensity trajectories across competing products at a company
• Monitoring whether a prospect's usage of your product category is increasing

Example Usage

{
  "tool": "company_install_time_series",
  "parameters": {
    "companyDomain": "cisco.com",
    "vendors": ["Amazon"],
    "timeRange": "last_12_months",
    "maxProducts": 5
  }
}

Response Format

{
  "organization": {
    "organization_id": "org-123",
    "organization_name": "Cisco Systems",
    "match_confidence": 0.95
  },
  "time_range": {
    "start_date": "2025-04",
    "end_date": "2026-04",
    "granularity": "month"
  },
  "products": [
    {
      "product_id": "prod-1",
      "product_name": "AWS CloudFormation",
      "vendor_name": "Amazon",
      "category": "Cloud Infrastructure",
      "is_active": true,
      "current_intensity": 82,
      "intensity_momentum": 3.5,
      "data_points": [
        { "date": "2025-04", "intensity": 18 },
        { "date": "2025-05", "intensity": 22 },
        { "date": "2025-06", "intensity": 25 }
      ]
    }
  ],
  "credits_consumed": 3
}

Error Handling

Common errors:

• 404 Not Found: Company domain not recognized — verify the domain and try again.
• 401 Unauthorized: HG API authentication failed — check that your HGInsights v2 API key is configured.
• 400/422 Invalid Request: Filter parameters are invalid — check product names, vendor names, or categories.

Related Tools

• company_technographic — Point-in-time technology stack snapshot (current installs)
• company_operating_signals — Operating signals and GenAI maturity derived from media mentions
• company_firmographic — Core company profile data (industry, size, revenue, location)