ai and all. Figures in the API describes the sides.
The score’s info button keeps its definition and range. This page holds the formula, engine weights and calibration method.
The raw score
On the AI side, each answer earns points:
A Weak answer earns the same 50 as a Mentioned one, even when it names you to criticise you. The score measures whether the engines put you in front of buyers. What they say about you is how AI describes you, shown next to the score and not part of it.
Averaged the same way as Mentioned and Recommended, the points come to the mean of the two, so the raw score is (Mentioned + Recommended) ÷ 2.
Engine usage weights
Each question weighs equally. Within it, each engine that answered weighs its share of usage, rescaled over the engines measured on that question. An engine your plan does not read, or one that returned nothing, drops out.
These weights use the share of adults who use each tool in Pew Research’s Americans and AI 2026, published on 17 June 2026. Pew’s share who read AI summaries is split between AI Overviews and AI Mode using Google’s monthly-user figures, 2.5 billion and 1 billion. Pew does not ask about Perplexity, so its weight is estimated relative to Claude using Similarweb’s May 2026 web-visit shares.
Adult usage, global monthly users and web visits measure different things. The latter two are estimates for the split and the missing tool. The same weights apply in every market. Updating them creates a new score version.
The Search side
Each result in Google’s top 10 takes a share of the clicks by its position:
For one keyword’s results page:
- A result on your own site counts toward Mentioned without reading the page. It never counts toward Recommended.
- A result on a competitor’s site counts toward that competitor’s Mentioned.
- Any other page counts toward Mentioned when Heralded’s reading of the page says it names you, and toward Recommended when the reading says it recommends you.
- A page Heralded has not read, or could not read, is unknown. Its share stays in the total and counts as not naming you, so Mentioned and Recommended are a lower bound. The unknown share is what the top of the range adds.
- For a competitor, a page whose reading did not cover that competitor is unknown too. A competitor added after the pages were read is unknown on them until they are read again, and one no reading covered is not measured.
- A results page that could not be fetched is wholly unknown.
All
All’s Heralded Score, Mentioned and Recommended equal the AI side’s. Their ranges, change and trends use AI answers too. This applies to every stored report at read time, so history stays comparable without a new break.Why the score is calibrated
Raw scores bunch up at the bottom. Most brands are named in a small share of answers, so a raw score of 15 can already put a brand among the real contenders in its category. Shown as-is, the scale would make nearly every brand look like a failure and hide real progress. Heralded places the raw score on a calibrated scale, where each number marks a measured position:
Between these points the scale is a straight line, with one addition at the bottom: a single named answer always reads at least 1. So 0 means that across the questions that don’t name you, no measured answer named you.
How the scale was measured
On 7 October 2026 Heralded refit the scale from 68 published category reads. The sample contains 7,921 answers and 3,208 brand and category observations. Brands are ranked within each category using the usage weights. Those runs read ChatGPT, Gemini, Google AI Overviews and Google AI Mode only. Their weights are rescaled over those four engines. The fit does not measure how adding Copilot, Claude or Perplexity changes a category’s scores.The score bands
Next to the score, Heralded names the band it falls in. Five bands cover the scale:
A Strong score sits between a typical top-three brand and a typical category leader. The band names a range of the score. It is not Recommended, the share of answers that recommend you.
The API serves the 50 to 69 band as
Recommended in heralded_score_band, score_bands and the band of a score, as it always has, and the names never change within v1. The topics read uses Strong for a topic’s band, its filter and its menu. The app, the emails and the share cards show it as Strong.