Skip to main content

Company Firmographic

Call this when a user asks about a company's firmographics — name, location, industry, employee/revenue size, corporate hierarchy, or global HQ. Use this (not company_research) for firmographic-only questions — it is faster and returns a smaller payload than a full profile.

Returns: name, industry_name, employees_total/employees_band, revenue_total/revenue_band, city/state/country, NAICS/SIC codes, Fortune 500 / Forbes 2000 rank, it_spend, company_level, and the corporate-parent / global_hq_* hierarchy fields.

company_level values: "Group HQ" (ultimate parent — global_hq_* fields are omitted), "Corporate Parent" (intermediate parent — global_hq_* carries the ultimate parent), or subsidiary. E.g. linkedin.com → company_level="Corporate Parent", global_hq_domain="microsoft.com". Chain global_hq_id to reach the ultimate parent (same as companyId for a Group HQ).

companyId is the queried entity's HG company id (32 uppercase hex chars) for chaining downstream.

No-match detection: the API always returns found:true. When companyId is "" (empty string) and firmographics is an empty object {}, no company was matched — do NOT rely on found as a sentinel.

When the org has a Snowflake integration configured, its own account record is attached as customerData.

Provide companyDomain or hg_id; hg_id takes precedence.

Do NOT use this when: the firmographic data is already in context (e.g. from a prior company_research call); you need the full multi-level ownership tree (use get_company_hierarchy); you need a full multi-signal profile (technographic + intent + spend) — use company_research; or you are filtering/building a list of many companies — use search_companies.

Parameters​

NameTypeRequiredDefaultDescription
companyDomainstring❌ No-The company domain to look up (e.g., 'cisco.com'). Either companyDomain or hg_id is required. Protocol prefixes (http://, https://), leading www., and trailing paths/queries/fragments are accepted and stripped automatically; case is normalized.
hg_idstring❌ No-HG Insights company ID (32 uppercase hex characters; schema accepts 31-32 alphanumeric chars). When provided, companyDomain is silently ignored. Obtain from a previous search_companies result.

Required Integrations​

  • hginsights_v2

Use Cases​

  • What industry and employee count does a company report? — single domain lookup
  • What is a company's estimated IT spend and revenue? — it_spend + revenue_total fields
  • Is company X a subsidiary of company Y? — company_level + global_hq_* answer hierarchy without get_company_hierarchy
  • I have an hg_id from search_companies — get the firmographic profile for it
  • What is a company's Fortune 500 rank and NAICS classification?

Example Usage​

Lookup by domain

{
  "tool": "company_firmographic",
  "arguments": {
    "companyDomain": "salesforce.com"
  }
}

URL is normalized automatically

{
  "tool": "company_firmographic",
  "arguments": {
    "companyDomain": "https://www.linkedin.com/about"
  }
}

Lookup by hg_id

{
  "tool": "company_firmographic",
  "arguments": {
    "hg_id": "25582D0E650950949A473EA7345C193E"
  }
}

company_research, get_company_hierarchy, company_technographic, company_intent, search_companies