Skip to main content
A question is something your buyers ask AI, tracked inside a topic for one market and audience. Heralded asks its wording for that country and language. ChatGPT, Gemini, Google AI Overviews and Google AI Mode answer daily. See daily updates and weekly reports for each engine’s cadence, including Europe. Your questions decide what every figure measures, so they are the most important choice you make in Heralded. Open All questions on Visibility, then search from Search questions. Typing applies after a short pause. Enter applies immediately, and clearing the search returns to the first page. Copy the address to keep your filters, sort, view and page. If a pane is open, the address also opens that pane. Reloading opens only the top pane.

Choosing questions

Good questions sound like someone who doesn’t know your brand yet and asks which options to pick, such as “best project management tool for agencies” or “which fast-food chains deliver late at night?”. A direct answer to a question like that names several brands of your kind, so it shows you against your competitors. “What is project management software?” gets an explanation instead, and says nothing about who gets chosen. How Heralded chooses questions explains how Heralded drafts them. Adopting a topic drafts one to three fixed questions and up to ten keywords for it.

How Heralded chooses questions

Your profile’s category names what people choose: the kind of thing an AI answer lists when your brand is one of the options, such as “fast-food chain”, “booking app for salons” or “online shoe retailer”. A maker that sells from its own shop is chosen as its kind of product, not as a shop. Where people usually start from a wider kind your brand also is, such as fast-food restaurants for a chicken chain, Heralded keeps that too, when an answer listing the usual options of that wider kind would include your brand. Before it plans a Snapshot’s topics or your brand’s first topics, Heralded looks up how people in your market search Google for that kind of thing. It also reads the questions people ask about it: Google’s People Also Ask and Reddit in your market’s language and in English, and Stack Exchange and ChatGPT questions in English. Then it plans your topics. Each topic is one shortlist asked for one situation: the kind of option the answer lists, and what the person chooses it for, such as a use, who it is for, a system it must work with, a rule it must meet, a place or an occasion. A family dinner, a delivery late at night and leaving a competitor are situations. A price, quality or popularity word such as free, cheap, best or popular is not, and neither is buying itself, so they never make one topic or question different from another. A brand with several offers gets a topic for each kind of thing it sells that people shop for on their own. Every topic is a choice made by the buyer your profile names: a booking app’s topics for salon owners are about the software they choose, not where to book. Heralded plans seven topics, in order of Google search demand, and a situation people in your market show comes before one only English ChatGPT questions show. A shortlist stays only when an answer listing the usual options of its kind would include your brand. A topic your brand would not reasonably appear on, or one that repeats another, is dropped, and your topics go on without it. Heralded writes each question in your market’s language, the way a local person would type it, with an English version beside it. A question uses the words people search with, and builds on a question people asked where one fits the topic. Where none fits, Heralded writes it from the topic and your profile. Questions speak for whoever chooses: a business buyer or a consumer, by who your brand sells to, or the audience’s own description when the topic has one. Whether your brand is ecommerce doesn’t change its questions. A topic’s three questions stay inside its shortlist and its situation, and each asks about a different side of it, such as the cheapest menus, a filling meal under a set price and cheap delivery for a budget lunch. Heralded plans what each question asks about across the whole set at once, so no two of your questions ask for the same list for the same reason. Every drafted question is checked before it is tracked or asked. A direct answer to it must name several options of its topic’s kind, and its wording must follow Heralded’s rules. A question that fails is drafted again once, inside its topic. One that still fails is dropped. A Snapshot drafts one replacement for it in the same topic, and a topic in your workspace keeps the questions that passed. A question that failed the check is never asked. Topics you add later, including suggested topics, are drafted and checked the same way. Questions you already track keep their wording. If keyword research is unavailable for your market and language, a need’s demand stays unmeasured. Unmeasured needs rank after needs with measured demand. A question keeps one tracking identity with country and language wordings. A Europe topic rotates where it asks the question; its master question stays the same. Every question has an English master and an asked wording for each country and language. Your question stays as you typed it. If you write in another language, Heralded creates the English master from it. A new English wording asked for a country names that country. A question asked in several languages shows its English master with markers such as EN · RO. A Europe question shows EN + 9 languages; hover over it to see them. A question asked in one language shows that wording with its marker. Hover over a local wording to read its English master. The question pane’s Markets list shows each country and language the question is asked in, with that market’s answers and the share naming you. When you edit the master, the label keeps the measured version until the new wordings are ready. Use Market and Audience in Filters to choose the topics whose answers you read. Market selects the topic’s market, so a Romania selection excludes Europe topics. Language markers keep each question’s wording clear. Add questions inside their topic’s panel. Select Add a question under Questions. A topic holds up to three active questions. When it is full, choose the question to replace. The replaced question keeps its history. The app API’s POST /api/domains/{id}/questions/fit checks the question’s fit and can name a better tracked topic with its places left, including when it is full. POST /api/domains/{id}/prompts accepts replace_prompt_uid to archive that question and add the new one in the same save. These writes require your Command Center session and permission to start work. The replaced question keeps its history. A question that needs a new topic goes through a topic preview. Your question stays first and word for word. New questions carry the first-answers estimate and first-score date.

Type and intent

Each question carries a type:
  • Organic, a category question that names no brand. Most of your questions should be organic.
  • Brand, a question that names your brand, such as “Is Acme any good?”. It doesn’t count toward your score; see which answers count.
  • Competitor, a question that names a competitor.
Each question also carries an intent: Problem, Educational, Comparison or Transactional. Heralded sets both, and a Member or above can correct them. Every question belongs to a topic, which you can filter by.

Pausing and archiving

A question is active, paused or archived.
  • Pause stops asking the question and keeps its last values. Resume starts it again.
  • Archive retires the question. Its daily answers are kept for 90 days.
A tracked topic holds up to three active questions. Pausing or archiving one frees a place in that topic. Adding or resuming a question requires its topic to be tracked. See Topics and questions. A question contributes to reads only while the question and its tracked topic are active. Stopping that topic keeps each question’s status. Restoring it brings back active questions; paused and archived questions stay stopped.

Visibility

Switch between AI answers and Google search on one page. Each side opens with a headline drawn from its measured figures under your filters. The headline stays hidden when there are no measured answers or rankings. AI answers shows the Heralded Score, Mentioned and Recommended, with definitions behind their info buttons. The weekly chart compares your score with the top competitors. Each point sits on its report’s date, so a week without a report leaves a gap. Table view shows the weekly values. Engine scores sit beneath the chart. Open an engine for its panel. Understood and Praised remain on Perception and inside the question and figure panels. Google search compares Mentioned in search across brands. Filtering by Position, AI Overview, You or Search keywords, or opening Archived, shows only your trend. Topics lists your topics with Score, Change, Searches/mo and Cited, the same table Strategy shows. Searches/mo adds up the monthly searches across a topic’s questions. A topic whose leader is not clear reads Too close to call. Change shows a dash where there is no change to compare, such as a topic’s first report; its info button says why. Add a topic sits beside Search topics. Open a row to see its questions, Google searches and work. New topics appear first and show their question count and first-score date until scored. Add a topic opens the shared topic preview. Suggested offers Track or Swap in when a replacement is offered. Not now puts a suggestion off or dismisses it, as Suggested topics describes. Archived offers Track again. Tracking and restoring offer Undo. Topics, All questions and All answers are the tabs above the lists. All questions opens your question table. All answers opens the full Answers page. All keywords on the Google side opens the keyword table. CSV downloads remain in Brand settings, under Export, for answers and weekly scores. Period stays beside Filters. It opens on Latest, and the period you choose carries to Competitors, Perception, Sources and Strategy. When a period holds fewer weekly reports than its weeks, its label says how many, such as Last 12 weeks · 5 reports. The Filters menu holds engine, type, intent, topic, market and audience. Your result offers Any, Named and Not named. Not named keeps questions with answers in the period where no selected engine names your brand. Active filters appear as removable chips. Clear resets them. Filters, list, sort, page and the open panel are saved in the address. Market and Audience narrow the questions to the topics you track for those buyers. Europe is one market, with figures averaged across its ten countries. Manage the available lists in brand settings. Tracked lists your active and paused questions, ten per page. Search questions searches their wording. Each row shows the question, with its topic, its kind of question and Searches/mo, the monthly searches for its topic, such as “~1,000”, on the line under it. Engine marks, Score and Change follow. Sort above the table also orders by Searches/mo. Tick the box before a question, under Select, to add its work with others. The kind of question is the intent plus the word question, such as “Comparison question”, and it names the type first when the question is a brand or competitor question, as in “Brand · Comparison question”. A paused question shows its pause date under its text. A low-quality question shows Low quality beside its kind of question. When you select another page, the current rows stay dimmed while Loading these questions… appears over the table. The pager is disabled until the new rows arrive. If they cannot load, the current rows return with an error above the table, and you can try again. Each dot is your Heralded Score for the question on one AI engine. The legend shows the five score bands and their ranges, plus Not measured. Hover a mark for its score, figures and answer count. Open it to read that engine’s most recent answer in the period. Open the row to read the question’s pane. A question you track from the topic’s Add a question control is read within minutes on every engine its topic reads, without waiting for the next daily update. Questions you track within a minute of each other are read together. The next time you open Visibility, the question’s pane shows each engine’s answer. Its marks stay Not measured until a weekly report scores it. A brand whose first report has not started yet reads the question in that first report. A question’s panel shows Heralded Score, Mentioned, Recommended and Searches a month. Mentioned and Recommended give the answers they count, as in “of 186 answers”; on a brand question they read Not counted on brand questions. Searches a month reads “<10” under ten. Each measured visibility figure has its change and small trend. See all opens the question’s full page at the selected list. The full page shows Understood as its fourth figure, compares Score, Mentioned and Recommended in one chart, and holds Google searches. The shared panel controls cover expanding, returning and copying its link. A question opens in the side panel that every object shares, described in How Heralded works. Members who can start work find Change type…, Change intent…, Pause tracking and Stop tracking in its ⋯ menu. A paused question offers Resume tracking there instead. Pausing and stopping apply at once and offer Undo. A question you stopped tracking has Track again as its main button. A message confirms each saved change or explains a failure. The score shows ”–” when fewer than three answers were measured, in the row and in each engine mark and card, as on every other figure. Change shows an arrow and the size of a real rise or fall, or Steady with the signed change. It shows New for a question first read in the period and First report for a question with no reading in the comparison period. Searches/mo stays empty when nobody has a number, and starts highest first. Select the Question, Score, Change or Searches/mo header to sort; select it again to reverse the order. Buyer needs worth tracking are suggested topics, listed in the Suggested view of Topics. Heralded groups evidence into buyer needs after each weekly report. Needs draw on your brand profile, Search Console, recurring engine searches, category questions, content gaps and keyword demand. Questions and keywords are drafted when you adopt a need. Dismissing a need keeps it out of later suggestions. Two phrases share a buyer need only when one answer would serve both buyers. A shared category, audience, product or vendor alone does not make them the same need. When the match is uncertain, Heralded keeps the phrases as separate needs. Suggested topics are the only suggestions. Read them through GET /v1/brands/{brand_id}/topics?view=suggested or MCP get_topics with view=suggested. Archived holds retired questions.

A figure’s pane

Open Mentioned, Recommended, Understood or Praised on Home, Visibility, Perception, a question or an engine to read that figure. On the Search side, Mentioned and Recommended open their Google pane. The selected period and filters stay with the panel. One tile holds the number, change, small trend and the population it covers. Your place compares you with the other brands where that figure ranks brands. Mentioned and Recommended list the weakest questions driving the figure; Understood lists Facts in AI answers; Praised lists quoted positive and negative AI answers. Each fact or quote opens its detail. Engines, Who leads and Work on this follow. Understood has no brand ranking. Open an engine for its own panel under the same scope. A paused engine is marked Paused. The next step opens the work item. See all opens the figure’s full page at that section, where lists use the pager. The page adds the full trend chart, results by stage, Mentioned’s cited sites, Praised’s tone counts and See the answers. A new baseline stays marked on the change and chart.

Inside a question

Open a tracked question to read it in the side panel. Under the question, one sentence says how it is doing, then the period, the kind of question, its stage and the languages it is asked in. A paused or stopped question names its status and date first. A question no weekly report has scored yet is marked New and reads Asking now, then Answered, with the date of its first score. The notice for a low-quality question and any work in progress on the question sit at the top. Three figures follow: the Heralded Score with its band and its change since the previous report, Recommended, and Searches a month on Google. Open Recommended to see that figure with the question fixed in its scope. What each engine answers lists each engine’s latest answer in words beside its mark: Leads with you, Recommends you, Mentions you or Leaves you out. An engine still reading its first answer says so. Open an engine for its panel fixed to this question, or Read for its answer. Sites these answers cite lists the five sites cited most for the question, with their citation counts; open one for its panel fixed to this question, or follow See all sites to Sources with the question filter set. Work on this lists the work already on the question and offers more where a kind of work fits. The header’s properties give Topic, which opens the question’s topic in the same panel, with Back to the question, in the same period. Market, Audience and Languages also appear in the header. Open as a page adds Tracked since. A notice says when the latest weekly report is a new baseline, so changes since the report before are not called. Mentioned, Understood and Praised each show the population their percentage covers; Understood and Praised cover answers naming you, and partial agreement contributes to the Understood percentage. Open one to see that figure fixed to the question. The score’s answer and engine counts cover the answers behind it. For Europe, these include only engines that answered in every country with answers. Trend shows the score by weekly report. The figure pane keeps its standard blocks under that question and the period and engine filters. Its figures, trend, engines, brands, lists and actions follow that scope. The closing link for Understood and Praised opens only the answers naming you. Engines shows a box for each engine with your score on it, its answer count and the four figures, each drawn by its band in shape as well as colour. Open a box for that engine’s pane, fixed to this question, or its answer icon for that engine’s latest answer. An engine filter leaves one box. Who leads lists the brands named on this question, highest score first, with their scores, Mentioned, Recommended and change. Your brand is tagged You and is listed even when no answer names you. It shows five. When you rank outside them, your row sits apart under You. Open a row for that competitor’s panel, or follow See all brands to Competitors with the question filter set. Markets opens from its heading, which shows its count. It lists each country and language the current wording is asked in, with its answers and the share naming you, most answers first and five at a time. When the question is asked in more than one language, Language narrows the list to one. Google searches lists what the engines searched on Google while answering the question, once for each search and market, most-run first and five at a time. Each row shows the engines that ran the search, its monthly searches and your Google rank: a position, Not in top 20, Checking, or a dash when it is not measured. A search with no volume number reads Under 10; a volume that is not priced yet reads as a dash. Monthly searches under ten read “<10”. When the list holds more than one market, each row names its market. A search that matches one of your keywords opens that keyword’s pane. All keywords opens Google search for the question’s topic, market and audience. See Google searches for how searches are grouped and ordered. See the answers opens the answers behind the question. The figure tiles keep their percentages. Their notes name the population measured, so the note does not imply a division that the weighted percentage does not use.

Low-quality questions

A comparison or transactional question exists to show which providers AI recommends. When its answers name no company, it can’t show where you rank.
  • Each answer counts once, in the first report that holds it.
  • Weekly reports completed in the same week count as one week.
  • Failed answers, and answers whose brands were not read, are left out.
  • A week with fewer than three counted answers is not measured.
A comparison or transactional question is low quality when fewer than 15% of its answers name any company in each of its last four measured weeks. It shows Low quality in the Tracked table, and a notice at the top of its panel offers Stop tracking, which then leaves the panel’s ⋯ menu. Its review is one item in Things to do on Home. Stopping the question completes it; add another question to the topic if you want one. Educational and problem questions are never flagged: they are often asked before a buyer has a shortlist. Pausing the question withdraws its untouched review on the next question-health check. Work you have started stays with you. On the API, each row of GET /v1/brands/{brand_id}/prompts and MCP list_prompts carries languages, master_version, the stored country and language wordings, and low_signal. GET /v1/brands/{brand_id}/prompts/{prompt_uid} and MCP get_prompt carry health. Both reads and MCP tools carry measurement_status, first_answers_at and first_score_on. measurement_status is new until a weekly report scores the question, then measured. The tracking status remains active, paused or archived. See First answers and score.

Answers

Open See the answers on Visibility, or follow See the answers at the end of a question, figure, engine, competitor, source or page pane. The pane’s link keeps its subject and filters selected. The link has no count and stays available when there are no matching answers. The Answers page shows the empty state. The Answers table shows one engine answer per row, 25 rows per page. All time lists every answer Heralded has read for your brand, including daily updates no weekly report has counted yet. Latest, Last 4 weeks and Last 12 weeks list the answers their weekly reports count. Narrow it by period, engine, question type, intent, topic, market or audience, then by Question, You, Names or Cites. Question selects one tracked question. Names lists the brands the answers name, tracked competitors first. Cites lists Your site once for your owned hosts, then other cited hosts. Search answers searches retained answer text. When a Sources group or page opens Answers, Cites shows that subject. Clear removes it. Each row shows Mentioned, Recommended, Understood and Praised, the answer excerpt, other brands named, how many cited sources are from your site, or None from your site, and the time in your time zone. The states are Yes, Partly, No and Not measured. Understood and Praised are not measured when the answer does not name you. The Question column disappears when one question is selected. Sort by Sources for answers that cite the most sources first, or When for the newest answers first. Open a row to read the full answer. The list, full answer and answers CSV use the same frozen measurements and detected brand names. Cited page labels use the title stored when Heralded read the page. A running scan’s answer uses live measurements until the scan finishes. When its text has passed retention, the row says Text no longer kept; its measurements remain. In the answers list, each answer is tagged with the language its question was asked in. A full answer also shows its text’s own language, which can differ from the question’s. Quotes and cited pages show their text’s language. Text whose language cannot be established shows no tag. Answer lists and full answers in the API and MCP carry asked_language for the question and language for the answer’s text. Perception quotes and opinion passages carry the same fields. Observed text language is unknown when the retained text cannot establish it, including quotes that are too short.

AI searches in the API

A question’s ai_searches shows the web searches engines ran while answering it. Each search names its engine and the dated answer that triggered it. These searches are leads for checking your Google rank, not evidence of what buyers ask. They do not become page-coverage questions. Read them through GET /v1/brands/{brand_id}/prompts/{prompt_uid} or the MCP tool get_prompt. The questions list and list_prompts carry the same searches. An empty list means no retained answer exposes searches. Each search has a google_rank with one of these states:
  • ranked gives your best position in Google’s top 20.
  • not_in_top_20 means a successful read of at least twenty results found no page of yours.
  • pending means a Google read is waiting to finish.
  • failed means the latest attempt failed, with its reason where available.
  • unmeasured means no recent read establishes your rank or absence, and no current pending or failed attempt exists.
A successful read from the last seven days still supplies the rank while another attempt is pending or failed. The rank belongs to the search’s market and audience. checked_at dates the Google read; observed_at dates the AI answer. A missing read never means you are absent from Google’s top 20. Weekly reports check up to twelve distinct AI searches per tracked topic, sharing a read when questions search the same text.

Google searches

ai_searches has one item for each engine and search. A question’s detail also carries google_searches, which lists each search once per market, with every engine that ran it. The questions list and list_prompts do not carry it. The detail returns every entry, unpaged. An entry is one search text in one market. The same text asked from Romania and from Moldova is two entries. Each entry has:
  • text, the wording of the newest answer that ran it.
  • country and language, the market of those answers. country is an upper-case ISO 3166-1 alpha-2 code, null for Global and for a Europe answer with no asked country. language is null only where the market is unresolved.
  • engines, every engine that ran the search, in the order of the question’s engine_vocabulary.
  • answers, the number of distinct question answers in the selected period that ran this search.
  • searches_mo, the monthly Google searches for the text in that market. It is null when no volume is priced or the vendor had no figure, and 0 when Google reports none.
  • volume_state, measured for a positive volume, zero for a confirmed zero, no_data when a lookup returned no number, or pending before a lookup.
  • google_rank, the same object ai_searches carries for that search and market.
  • keyword_id, the id of the question’s keyword with the same text and market, tracked or archived, or null when there is none.
  • last_searched_at, when the newest answer that ran the search finished.
Entries come first by answers, descending, then by searches_mo, descending with nulls last. Ranked searches then come before unranked searches by position, followed by the text A to Z. Heralded prices the searches your active questions’ answers ran in the last seven days once a month, in the same requests as your tracked keywords. Page coverage uses the topic’s questions and independent evidence questions. Heralded does not generate guessed sub-questions for that checklist. Google search on Visibility reads Google results for your tracked keywords. It measures whether the pages buyers click on Google show you, and whether a third party on them recommends you. It has no score or band. The Heralded Score uses AI answers only. The figure band shows Mentioned in search, In the top 3, In the top 10 and Positions. The first three include weekly trends and served changes when a comparable earlier window exists. Positions shows the checked rankings and their distribution; empty position bands stay out of the key.

Keywords

A keyword is how a buyer searches Google for a topic, in one country of the topic’s market. Heralded finds up to three keywords for each topic in Global or a single-country market, and up to two in each Europe country, beside its questions. You can add your own up to three per topic and country in Europe and ten in Global or a single country. The country limit is shared across its languages. See Topics. Heralded checks Google’s top 10 every week in every country of your topic’s market. It measures up to three active keywords per topic and country for Europe, and ten for Global or a single country. Your added keywords take priority, followed by the keywords with the highest known search volumes. Keywords beyond that limit stay tracked but are not checked. Global reads the United States in English. Your first report reads keywords available before it hands off to scoring. Google reads that arrive late fill in while the report is partial. See first report timing. New keywords are checked on the next daily update, within a day. A keyword you restore after an earlier check waits for the weekly report. Each weekly report freezes its checks and those from daily updates, so a figure never moves when a page or a search volume changes later. A scheduled weekly report waits up to 30 minutes after its last keyword results arrive for the pages it needs to read. Your first report waits for Google results and pages until 17 minutes from confirm, then opens on what is measured. Late reads fill in until it is final at about 30 minutes. Pages still unread count as unknown. Heralded finds a topic’s keywords from its category, not from your site: where you should rank, not where you rank today. It starts from the searches buyers type for your category and for each topic, in each country’s own language, and Google’s Keyword Planner widens them into the related searches people make, with their monthly volume. Heralded keeps the ones that fit the topic, searches people make first and highest volume first, one per group of close variants such as “ai seo” and “ai for seo”. It leaves out searches that are a one-off task with a provider, such as paying a phone or electricity bill or logging in, and never treats two searches as variants only because their volumes match. Your category’s most searched terms go to the topic they fit best. Belgium and Switzerland search in both local languages. A topic with few searches that fit it takes broader ones that still do, and keeps the searches Google holds little or no volume for: their ranks are still tracked, Searches/mo shows the volume or Under 10, and the topic shows Low search demand. Keywords are found when a topic is tracked, or suggested during setup, and again only when its need or market changes. Their volumes are refreshed every month. Keywords you add or restore stay tracked whatever their volume, and take places first. A keyword can have a rank without volume data. Each country’s keyword is its own search with its own volume and rank; another country’s search for the same topic is another keyword, not a translation. The keyword API returns each keyword’s country, volume and latest rank. Search change pairs a keyword with itself in the same country. A keyword that names your brand stays out of the Search figures. It is still listed.

What a keyword shows

How a keyword is measured

Each result in the top 10 takes a share of the clicks by its position. A result on your own site counts toward Mentioned. A result on another site counts toward Mentioned when Heralded’s reading of the page says it names you, and toward Recommended when the reading says it recommends you. Your own pages never count as a recommendation. Keywords have Mentioned and Recommended shares, with no score or band. The Search side gives the click shares. A page Heralded has not read counts as not naming you, and its share is shown as unread. So an unread page can lower a figure and widen its range, and never raise it. A keyword’s range runs from the share Heralded read to that share plus the unread share. A keyword is shown once one check has fetched its results.

The keyword table

Group by Topic is the default. Each topic shows its keyword and market counts, combined searches, best rank and its market, checked rankings in the top 10, Mentioned in search and change. Its Mentioned figure agrees with the topic’s Search figure in its topic panel. Expand the chevron to see only that topic’s keywords, one per keyword and market. Open the topic name to read its pane. AI Overview stays in the Keyword and None views and the keyword pane. Google search shows how you rank on the Google searches AI runs for your questions. Its summary shows Mentioned in search, In the top 3, In the top 10 and the position distribution. Mentioned in search reads Not measured when its value is unavailable. In the top 3 and In the top 10 count the rankings checked in the period, out of all of them. The position distribution reads each ranking’s latest check, an earlier one too. Every filter changes the summary and the table together. Open Mentioned in search for the full figure. Filter by Period, Market, Audience, Topic, Country, Position, AI Overview or You. You keeps the rankings whose latest check Mentions you or Recommends you. Market selects the topic’s market; Country selects where the ranking was checked. Changing Market clears Country. Global reads the United States in English. Remove the Country chip or choose Clear to reset it. On a phone, open Filters for everything except Period. Group by Keyword brings together the searches that share an English meaning, across topics and markets, so each meaning appears once. Each row shows its topics, their markets, combined known searches, best rank and its market, markets in the top 10, AI Overview, Mentioned in search and change. Combined searches count Under 10 as under ten. A group none of whose searches has been checked shows Not checked as its best rank and — for In top 10. Otherwise, In top 10 shows the number of checked markets in the top 10 out of the checked markets. Mentioned in search and change show once any of its searches has been checked. With a Topic filter, a group with a search in that topic keeps its searches in other topics, and the page line and summary count the topic’s rankings. Expand the chevron to see each market’s own words, volume, rank and figures. Open the group title to read the keyword with the most monthly searches. Group by Market shows one row per market with its rankings, searches and figures. Open a market to see its individual keywords under Group by None. Browser Back returns to the market list. None also shows the topic beside each keyword. Every grouping shows 10 rows per page. Search keywords matches the keyword, its English meaning or its country’s name. Sort from a column head, or the Sort menu on a phone. Tracked includes paused keywords; Archived includes archived keywords and those in archived topics. Each tab counts the rows its view lists under your filters and grouping. The headline describes the measured searches where you rank on page one. A ranking is one keyword in one market. The positions bar separates Top 3, 4–10, Not in top 10 and Not checked. A change across a non-comparable break carries New baseline. Open a keyword to read its Google rank, English meaning and monthly searches. Market chips show the same keyword in its other tracked markets; choosing one replaces the keyword while keeping the period and report. Your rank, Mentioned in search and Competitors ahead each have a small trend. Mentioned includes its measured change and the possible share from unread results. Outside the top ten, the third figure counts Competitors in the top 10 instead. Google results shows five ordinary results. Each opens its own page, a competitor page or another cited page. An AI Overview sits before the results and does not count among them; its line shows whether it names you and which tracked rivals it names when those readings are available. Your best page sits separately when it falls outside the preview. Questions that search this lists questions whose background searches contain the keyword; Work on this lists work about its ranking pages. See all opens the keyword’s full page at that section. Results and questions page through every row. The page adds the full rank-history chart and the last checked date. Topic and market properties open their related objects. The shared panel controls cover expanding, returning and copying its link. Open either figure on the Google search side to see its click share, change and small trend. Your place compares you with other brands. Rankings that mention you or Rankings that recommend you lists five keywords driving that share. Your ranking pages, Who leads and Work on this follow. Each keyword opens under the selected period, market, audience and report. See all opens the figure’s full page at the selected section. The page adds the full trend, totals and By market. Each market row opens Visibility filtered to that market. Lists page through the same selected population.

Add a keyword

Open the topic’s panel, switch to Google search, and select Add a keyword in its searches list. A keyword can have up to 80 characters and 10 words. A topic holds up to three keywords per country in Europe and ten in Global or a single country. A country picker appears when the topic needs one. Your keyword replaces a researched keyword when that country’s places are full. If all its places hold keywords you added or restored, stop tracking one first.

Read search visibility through the API

Every figure here is also in the API, and each has the same value wherever you read it.
  • side on the overview, scores, competitors and topics reads the AI side, the Search side or All. Sides states how.
  • Scores and MCP get_scores take with_search_detail=true with with_panes=true and side=search for Search detail. They accept market for one country or global, as the keywords read does. The default response stays unchanged.
  • A topic’s scores carry all, ai and search. See Topics.
  • GET /v1/brands/{brand_id}/keywords and MCP get_keywords accept group, market, position, ai_overview, mentions, q and with_summary. Every keyword includes mentioned_change. One keyword also adds rank_series, your best Google position at each weekly report. Keywords lists the contract.

Products in AI answers

For a brand with Ecommerce on, the questions table adds Product cards. Each tile counts a distinct product across the question’s read answers. Amber tiles are yours. A dash means no product cards appeared. A dashed cell means cards were not read or not measured, as its accessible label states. The column’s information button explains the tiles. Brands with Ecommerce off and Google search show no product-card column. An ecommerce question’s pane includes Products, with brand marks, Answers, Best card, price and seller. Your products say You. Select a product to open its pane. The list pages through all products shown on the question. Products defines the figures and read states.