Skip to main content

Product Momentum (beta)

Product momentum tells you how well a product is doing in its market right now, compared with the other products in the same peer group. GTM teams use it for competitive displacement: get each competitor's momentum, judge which ones are weakest in their peer group, then find the companies that use them.

Agents get momentum from the product_search_and_enrich tool on HG MCP by adding fields: ["momentum"] to an enrich call.

Beta signal

Momentum is a beta signal. Every answer that uses it must say so and must name the evaluation month the scores come from.

What it is​

Momentum is evaluated monthly from HG Insights install evidence. Not every product has a score in every month (see When a product has no score).

TermMeaning
Momentum score0–100. Footprint × traction, scaled within the peer group for that month: 100 is the strongest product in the group, 0 the weakest.
FootprintThe product's install base: how many organizations use it, how deeply, and across how many countries, measured against the peer group.
TractionThe growth of that install base: how fast organizations adopt the product and how well it keeps them, measured against the peer group.
TierA confidence tier based on the size of the install base: Mature, Emerging or Sparse.
Evaluation monthThe month the scores describe, given as its last day (for example 2026-10-31). The tool returns the latest month.

Footprint and traction are relative measures computed against the peer group, not counts of companies. Like the score, they compare only within that group.

Momentum comes in two views, and each view has its own peer group:

  • By category: the product against the other products in the same category, in the same month. Each category row carries two tiers. category_tier is the product's tier within its category, with the thresholds scaled to that category's median install base. global_tier is based on the product's global install base against fixed thresholds, so it doesn't depend on the peer group.
  • By category × NAICS industry: the product against the other products installed in the same NAICS industry, in the same month. Each industry row carries industry_tier, the product's tier within that industry. Industry rows also carry a category_tier, which can differ from one industry to the next and from the by_category row. For the product's tier in its category, read by_category.

Momentum is built from install evidence. It is not intent data: it describes where a product is installed and how that install base is moving, not which companies are researching a purchase.

Rules for using it​

  1. Compare scores only within one peer group. A peer group is one category in one month (by_category), or one NAICS industry in one month (by_industry). Rank products against each other only inside that group. Never compare a score or tier from one category or industry with a score or tier from another, and never compare scores from different months: every group is scaled on its own, so a 60 in one group and a 60 in another don't mean the same thing.
  2. Always name the evaluation month. Say which month the scores describe, for example "October 2026".
  3. Say it's beta. Momentum is a beta signal; say so wherever you use it.

Each momentum block in the response carries a note that repeats these rules, so an agent has them next to the data.

How to request it on HG MCP​

Call product_search_and_enrich with action: "enrich":

ParameterValue
action"enrich"
products1–50 products, each { "product_id": <id> }. Get the ids from an action: "search" call.
fields["momentum"]. Adds a momentum block to every product row.
naics_industriesOptional. 1–10 exact NAICS industry names, as search_industries_naics_sic returns them. Only valid with fields: ["momentum"].

By default, each product's momentum block holds all of its category rows, plus its 10 industries with the largest footprint and industry_count, the number of industries the product has a score in.

With naics_industries, the block holds the category rows plus at most the industries you named, in place of the default 10. A named industry the product has no score in is left out without an error. Use search_industries_naics_sic to find the exact industry names.

fields is only valid with action: "enrich". A search call with fields is rejected.

Example request​

Momentum for three CRM products (Zoho CRM, Pipedrive and SugarCRM), with the default industries:

{
"action": "enrich",
"products": [
{ "product_id": 4988 },
{ "product_id": 9110 },
{ "product_id": 441 }
],
"fields": ["momentum"]
}

The same products, with two named industries in place of the default 10:

{
"action": "enrich",
"products": [
{ "product_id": 4988 },
{ "product_id": 9110 },
{ "product_id": 441 }
],
"fields": ["momentum"],
"naics_industries": ["Software Publishers", "Custom Computer Programming Services"]
}

The response​

Each enriched product row keeps its usual catalog fields and gains a momentum block:

FieldTypeMeaning
evaluation_datestring or nullThe evaluation month, as its last day (YYYY-MM-DD).
betabooleanAlways true.
notestringNames the month in words and repeats the peer-group rule, the beta status and that momentum is not intent data.
by_categoryarrayOne row per category the product belongs to.
by_industryarrayUp to 10 industry rows: the default top 10 by footprint, or the industries you named.
industry_countintegerHow many industries the product has a score in this month, however many rows are shown.

by_category rows:

FieldMeaning
category_nameThe category (the peer group, with the month).
momentum_score0–100 within that category and month.
footprintInstall base, against the category.
tractionGrowth of the install base, against the category.
category_tierMature, Emerging or Sparse, within the category.
global_tierMature, Emerging or Sparse, from the global install base.

by_industry rows:

FieldMeaning
naics_industryThe NAICS industry (the peer group, with the month).
category_nameThe product's category. In these rows it is not the peer group.
momentum_score0–100 within that industry and month.
footprintInstall base in that industry.
tractionGrowth of the install base in that industry.
industry_tierMature, Emerging or Sparse, within the industry.
category_tierA category tier given per industry row. It can differ between industries and from the by_category row; read the product's category tier from by_category.

Example response​

This is the response to the first request above, abbreviated. It shows one of the three products, leaves out the catalog fields every enriched row also carries (product_details, category_info, vendor_info), and keeps 2 of the product's 10 industry rows. Every value shown is as returned.

{
"products": [
{
"product_id": 441,
"product_name": "SugarCRM",
"momentum": {
"evaluation_date": "2026-10-31",
"beta": true,
"note": "Beta signal. Evaluation month: October 2026. Momentum scores and tiers rank a product only within one peer group: the same category and month (by_category) or the same NAICS industry and month (by_industry). Do not compare scores across peer groups. Built from install evidence; this is not intent data.",
"by_category": [
{
"category_name": "Customer Relationship Management Applications",
"momentum_score": 43.222900390625,
"footprint": 16.457700729370117,
"traction": 0.5529530048370361,
"category_tier": "Mature",
"global_tier": "Mature"
}
],
"by_industry": [
{
"naics_industry": "Software Publishers",
"category_name": "Customer Relationship Management Applications",
"momentum_score": 30.292699813842773,
"footprint": 10.90999984741211,
"traction": 0.44480401277542114,
"industry_tier": "Mature",
"category_tier": "Mature"
},
{
"naics_industry": "Other Foundation, Structure, and Building Exterior Contractors",
"category_name": "Customer Relationship Management Applications",
"momentum_score": 64.32969665527344,
"footprint": 10.07859992980957,
"traction": 1,
"industry_tier": "Sparse",
"category_tier": "Sparse"
}
],
"industry_count": 483
}
}
]
}

Three things to notice:

  • The industry score of 64.33 is not "better" than 30.29. They come from two different peer groups (two industries), so they can't be compared. The Sparse tier also says the 64.33 rests on a small install base.
  • That industry row's category_tier is Sparse, while the by_category row says Mature. The product's tier in its category is the by_category one.
  • industry_count is 483: the product has a score in 483 industries this month, and the response shows the 10 with the largest footprint.

When a product has no score​

A product with no momentum score for the evaluation month still gets a block. Its by_category and by_industry are empty, industry_count is 0, and the note ends with a sentence naming the month, for example "No momentum score for this product in October 2026." If no evaluation month is available at all, evaluation_date is null and the note says that no momentum month is available yet.

When momentum can't be fetched​

If momentum can't be fetched, the whole call fails and returns no rows. It isn't charged. When the momentum lookup itself fails, the error starts with either "Product momentum is temporarily unavailable; the catalog records are still available by calling this tool without fields." or "Product momentum could not be fetched:", followed by the reason.

A call with fields: ["momentum"] can also be refused before any lookup, for example when the server can't identify the HG Insights account making the call. It fails the same way, isn't charged, and returns its own error message.

Price​

Asking for momentum doesn't change the price: 1 AI credit per matched product, with or without momentum. Product ids that don't match aren't charged, and a call that fails because momentum can't be fetched isn't charged. See AI credits for how credits work.

Competitive displacement walkthrough​

Use momentum to decide which competitors to displace, then find the companies that use them.

  1. Find the competitors' product ids. Resolve the category with get_product_category, then call product_search_and_enrich with action: "search" and filters.category_id (add filters.product_name to narrow to a name). For example, "Customer Relationship Management Applications" gives Zoho CRM 4988, Pipedrive 9110 and SugarCRM 441.

  2. Get their momentum. Call product_search_and_enrich with action: "enrich", the ids and fields: ["momentum"], as in the example request. Add naics_industries to look at the industries you sell into.

  3. Compare within one peer group. All three products share the category and the evaluation month, so their by_category rows can be ranked against each other. For October 2026 the example gives Pipedrive 63.4, Zoho CRM 59.5 and SugarCRM 43.2, all Mature. To compare within an industry, use the by_industry rows for that same naics_industry. Whatever you conclude, say it's beta and name the month.

  4. Find the companies that use the product you're targeting. Call search_companies with an installs filter on its product id, and narrow it with firmographics such as country or size:

    {
    "installs": {
    "products": [{ "ids": [441], "inclusion_method": "ANY_PRESENT" }]
    },
    "firmographics": {
    "country_codes": [{ "ids": ["US"], "inclusion_method": "ANY_PRESENT" }]
    },
    "limit": 3
    }

    The response lists matching companies and a total_count of all matches.

A low score is a reason to look closer, not proof that the product is losing customers. Momentum describes the install base. Pair it with other signals before you act.

Where it's available​

Momentum is served by the product_search_and_enrich tool on HG MCP, with fields: ["momentum"]. It is not documented here for any other surface.

If you call product_search_and_enrich with fields: ["momentum"], matched product rows come back, and none of them has a momentum block, your client is connected to a server that doesn't serve momentum.