Skip to main content
Your competitor data covers the brands you track, suggested brands found in AI answers, and platforms AI names. The AI leaderboard ranks brands by Heralded Score. Google search ranks by Mentioned in search. Share of voice shows each brand’s part of the names in your answers. Open Competitors under Insights to manage your roster and compare its figures. Switch between AI answers and Google search. The page shows your rank, share of voice and tracked competitor count.

Your roster

You track up to 10 competitors per brand. Your own brand appears in the leaderboard without using a place. Tied figures share a rank. A brand without a measured score keeps its row. The Tracked tab shows the first five brands; All 10 competitors shows the rest. Change shows each brand’s weekly change and is left out when no brand has one. After your first report, a competitor with no comparison score reads Calibrating. The same label appears on Home and in your weekly report. During setup, your competitor list starts with the competitors Heralded identifies from your website. You can remove them or add others before starting your first report. Your first report can fill remaining places with the competitors its answers name most, among the brands Heralded is confident compete with you. Your own brand and its owned websites cannot be added as competitors. A competitor you add later is matched against the latest report’s answers. Its Mentioned counts its own measured answers and says since when those start later within the selected period. Choose Add a competitor and enter a name. Check the suggested name and website before choosing Add. You can change the site or enter one yourself. A brand can make up to 10 website searches in a rolling 30-day window. Once those are used, you can still enter a website yourself. A competitor without a website keeps its place, with its site data unavailable. Open the competitor, then choose Edit website from its ⋯ menu to enter its address. To swap competitors when your roster is full, stop tracking one and track another. Stopping tracking and tracking a suggestion offer Undo. Readers without permission to edit competitors can read the same figures without changing the roster. For brands with Ecommerce on, the AI table adds Product cards, the share of answers with organic product cards that showed a brand’s products. Select the column heading to sort by this share. The information button gives its definition. This column is absent on Google search and for brands with Ecommerce off. See Products for the figures’ definitions.

Suggested competitors

The Suggested tab holds alternatives AI names that you do not track. Their rows show mention frequency, answer and question counts, and a score once at least three answers name them. You can open a brand to compare it with yours, or track it when your roster has space. Confidently matched spellings, abbreviations and regional names count as one competitor. Different products you choose between stay separate. Each answer counts once for a competitor, however many spellings it names.

Platforms AI names

The Platforms AI names tab holds platforms such as YouTube, LinkedIn, Reddit and Medium. They take slots in share of voice but have no competitor score or rank.

A competitor’s pane

The header names the competitor’s domain and focus status. The figures compare its Heralded Score, gap to you, Mentioned and Recommended, each with a small trend. Where they beat you lists questions where its score is higher than yours. Ties and missing scores appear in neither the lost nor won list. Changes on their site shows recent website moves. Open one to read the stored comparison. How AI describes them follows, then Work on this and Cited pages. A next step opens its work item. Track appears for a competitor you do not track; Edit website and Stop tracking sit in ⋯. Stopping tracking offers Undo. For an ecommerce brand, Products lists that competitor’s products with Answers, Best card, price and seller. Each product opens its own pane, and the list pages through all matching products. See all opens the competitor’s full page at the selected section, with paged lists and breadcrumbs back to where you came from. The page adds its full website details, pricing and checks, questions where you beat it, engines, the score chart and the answers behind the figures. Its tracking date appears in the properties column. A competitor page shows why it works, how many of your questions cite it, the citing questions and work targeting that exact page. Its competitor property opens the competitor. See all opens the page at the selected list; the full page adds engines and citation history. The outbound link opens the original website. Missing AI descriptions say No description recorded. The full competitor page also names the positive and negative opinions with the most supporting answers when those opinions were recorded.

Filters

Figures follow the selected period and filters. AI descriptions come from the latest completed interpretation within the selected report cutoff and do not change with figure filters. Search shows Mentioned and Recommended in search, without an AI score.

Website moves and comparisons

What moved sits above the competitor table when a competitor published, removed or changed something on its site, grouped by competitor and kind of move. Home page and pricing changes come first, then new pages and removed pages. See all shows every move, with filters for competitor and change type; choosing a change type lists each page. Files such as PDFs and images never count as pages. Choose See what changed to see the headline or plans before and after, or the pages. Work on this appears where Heralded has a fitting kind of work. You can select several moves and add them to Work together. The weekly site read includes page counts, new and removed pages, key pages, homepage checks, pricing and changes. Each competitor carries the week its site was checked. New and removed pages come from the competitor’s own sitemap, read once a day. A page is new when the sitemap lists it and the last complete reading did not, and removed when it is the other way round. The first reading only sets the starting point. A competitor without a readable sitemap, or whose sitemap is too large to read in full, shows no page moves. A site that could not be read stays unavailable or retains its last completed read. You can open each monitored key page even when no answers in the selected period cite it. Its panel shows the page and its competitor, with an empty citation list. A home page counts as changed when its headline, compared by words and ignoring case and spacing, differs from the previous week’s stored headline. A pricing page counts as changed when its plan names or prices differ from the previous week’s stored plans. A page whose text moved without either change is not a move, and other key pages are not compared. A missing earlier value stays missing. Comparisons do not reconstruct page text or an earlier screenshot; missing comparisons say No stored reading. For new pages and removed pages, See what changed lists the pages the move covers. A competitor site is never given a Website score.

Read competitors through the API

GET /v1/brands/{brand_id}/competitors?with_details=true returns the leaderboard, roster capacity, discovered brands, platforms, share of voice, stored AI descriptions and weekly site moves in one read. MCP list_competitors accepts the same option. GET /v1/brands/{brand_id}/competitors/{key}?with_details=true adds that competitor’s site and comparisons to its figures, lost and won questions, engines and cited pages. MCP get_competitor serves the same data. The website feed includes up to 20 moves in the combined read. Use the competitor website read to filter and page the remaining stored changes. Data keeps the same plan availability as its original reads. Figures in the API defines every field.