Company Install Time Series

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

Overview

company_install_time_series returns monthly intensity values (0–100 scale) for each product a company uses, enabling trend analysis over configurable time windows. 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 — latest intensity score (0–100)
• intensity_momentum — positive means growing, negative means declining
• is_active — whether the product was verified within the last 90 days
• data_points — monthly intensity values 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	salesforce.com	Company domain to look up (no protocol).
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": 68 },
        { "date": "2025-05", "intensity": 71 },
        { "date": "2025-06", "intensity": 74 }
      ]
    }
  ],
  "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)