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.
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).
| Term | Meaning |
|---|---|
| Momentum score | 0–100. Footprint × traction, scaled within the peer group for that month: 100 is the strongest product in the group, 0 the weakest. |
| Footprint | The product's install base: how many organizations use it, how deeply, and across how many countries, measured against the peer group. |
| Traction | The growth of that install base: how fast organizations adopt the product and how well it keeps them, measured against the peer group. |
| Tier | A confidence tier based on the size of the install base: Mature, Emerging or Sparse. |
| Evaluation month | The 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_tieris the product's tier within its category, with the thresholds scaled to that category's median install base.global_tieris 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 acategory_tier, which can differ from one industry to the next and from theby_categoryrow. For the product's tier in its category, readby_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
- 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. - Always name the evaluation month. Say which month the scores describe, for example "October 2026".
- 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":
| Parameter | Value |
|---|---|
action | "enrich" |
products | 1–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_industries | Optional. 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:
| Field | Type | Meaning |
|---|---|---|
evaluation_date | string or null | The evaluation month, as its last day (YYYY-MM-DD). |
beta | boolean | Always true. |
note | string | Names the month in words and repeats the peer-group rule, the beta status and that momentum is not intent data. |
by_category | array | One row per category the product belongs to. |
by_industry | array | Up to 10 industry rows: the default top 10 by footprint, or the industries you named. |
industry_count | integer | How many industries the product has a score in this month, however many rows are shown. |
by_category rows:
| Field | Meaning |
|---|---|
category_name | The category (the peer group, with the month). |
momentum_score | 0–100 within that category and month. |
footprint | Install base, against the category. |
traction | Growth of the install base, against the category. |
category_tier | Mature, Emerging or Sparse, within the category. |
global_tier | Mature, Emerging or Sparse, from the global install base. |
by_industry rows:
| Field | Meaning |
|---|---|
naics_industry | The NAICS industry (the peer group, with the month). |
category_name | The product's category. In these rows it is not the peer group. |
momentum_score | 0–100 within that industry and month. |
footprint | Install base in that industry. |
traction | Growth of the install base in that industry. |
industry_tier | Mature, Emerging or Sparse, within the industry. |
category_tier | A 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
Sparsetier also says the 64.33 rests on a small install base. - That industry row's
category_tierisSparse, while theby_categoryrow saysMature. The product's tier in its category is theby_categoryone. industry_countis 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.
-
Find the competitors' product ids. Resolve the category with
get_product_category, then callproduct_search_and_enrichwithaction: "search"andfilters.category_id(addfilters.product_nameto narrow to a name). For example, "Customer Relationship Management Applications" gives Zoho CRM4988, Pipedrive9110and SugarCRM441. -
Get their momentum. Call
product_search_and_enrichwithaction: "enrich", the ids andfields: ["momentum"], as in the example request. Addnaics_industriesto look at the industries you sell into. -
Compare within one peer group. All three products share the category and the evaluation month, so their
by_categoryrows can be ranked against each other. For October 2026 the example gives Pipedrive 63.4, Zoho CRM 59.5 and SugarCRM 43.2, allMature. To compare within an industry, use theby_industryrows for that samenaics_industry. Whatever you conclude, say it's beta and name the month. -
Find the companies that use the product you're targeting. Call
search_companieswith 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_countof 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.