query_metrics and the other tools return.
Measures
resolve_ids with kinds: ["measure"] serves each measure’s definition and the evidence behind it, and the facets to filter and group by.
Ranges and “not significant”
- Every share comes with
range95, the margin either side of the value. The answers to one question count as one cluster, so ten answers to one question are not ten pieces of evidence. - Under 20 answers a share is weak. The free level withholds it and returns
below_floor. compare: "prior"compares a window with the one of equal length before it, on the questions asked in both (matchedQuestions).significant: trueneeds three things: at least 20 answers in each window, at least 5 matched questions, and a change outsidechangeRange95. Report only significant changes; the reply’scontext.significancesays the rule.compositionis how much of the change comes from which questions were asked, not from how the answers changed.explain: "change", with a subject andcompare: "prior", splits a change into same-question change and question mix, and lists engine model changes by date.
Windows
- The default is the last 28 days.
window.lasttakes7d,28d,90d,365dorall; or givefromandtoas YYYY-MM-DD, in UTC.by: ["week"]orby: ["month"]gives a trend on matched questions.- The last 90 days, ending on the snapshot’s last day, are free. A window that reaches before them reads past answers: a public answer from then costs $0.001 the first time the workspace counts it, and is the workspace’s after; its own answers are never charged. The charge is in
meta.costCredits(Spending).
context.sampletells you when a past read was sampled (for example, “1 in 4”). Use answer-level shares and their 95% ranges as reported. Counts describe the sample. Question-level measures such assearch_reachandshare_spreadfavor questions asked more often, because those questions are more likely to appear in the sample.context.historyreportsfreeFrom,pastAnswers,newToWorkspace,chargedUsd,moreToCountAllUsd, andbudgetLeftUsd;nextcarries the ready-to-runhistory: "all"call.- If a workspace cannot buy past answers (no credit, spending paused, or logged out), the call reads the last 90 days plus any past answers already owned and notes approximate omitted past rows under
limits: [{ what: "history_unpaid" }]. - Assistants get no single weekly “mentioned in” figure: it moves when the questions do.
What is counted
- ChatGPT and Google AI Mode, unless
filter.engineorfilter.surfaceClasssays otherwise, orbynamesengineorsurface_class.context.surfacesnames what was counted. - A
subjectwith no filter reads the brand’s own markets (up to three), andcontext.scopenames them.filter: {}reads every answer. level: "product"measures one product apart from its company.filter.placeis the place a question is about;filter.countryis where it was asked from. See Agencies and local businesses.
filter.scope says whose answers:
Levels
Every data reply says inmeta.level whether it read in full or at the free level, and in meta.levelReason why.
- The free level, with no key or no credits: samples of up to 5 rows with no paging, shares only over 20 or more answers, and excerpts in place of full texts.
- The workspace’s own brands are read in full with or without credits.
- Deep paging and exports need a first card top-up: a search that names no brand, market, topic, question, page or site pages no further than its first page, and
exportwrites nothing, until then.
Missing is not zero
{ "missing": "<reason>" } (for example below_floor, not_collected or withheld) means Parse has no value there. Say why, or run the call that fills it; next names it when there is one.
When Parse’s data changed
context.dataChanges lists the days a backfill moved counts without any change in the AI answers themselves, with what was returned. A count over those months can differ from a reading before the date. Dated entries are on the Changelog.
Why the app can differ
Mentioned in uses the same extraction rule across surfaces. The answer sets differ. The app’s weekly tables count mentions the agent service does not, and the Overview reads answer packs built from answers with usable extraction. The agent service reads collected answers in the requested scope and window. The Overview reads the last 28 days and the public rank counts answers since May 24, 2026. The app prints a change when it passes a pooled test at 85% confidence. The agent service reports 95% ranges on matched questions, so fewer changes read as significant.context.measures.differsFromDashboard says this in every reply. When a person’s app figure and the assistant’s disagree, neither is wrong: they count differently. Tell the person which one you are quoting.