Get AI search visibility numbers for a date range
visibility_get_summaryReturns the numbers behind the Visibility dashboard in Hi, Moose for one date range, with the same filters the dashboard offers: topics, engines, prompts, branded or non-branded prompts, pages cited, sentiment, narrative, feature parity, plus mentioned, cited and competitor. Pick sections to keep the result small: totals (always), engines, topics, prompts, trend (per day), competitors (share of voice, per engine and topic, pages competitors get cited from, prompts competitors win), citations (pages and domains the engines cite with counts per engine, own and competitor domains flagged, paged with citationsLimit and citationsOffset), mentions (every brand named, with rank and sentiment). Pass compare true for the equal window before, or compareFrom and compareTo, to get the same totals for a second window. Use this for reports, dashboards and "how are we doing" questions; use visibility_list_results for the individual answers behind a number and visibility_check_topic for a one-topic question in plain words. Counts cover the tracked prompts on the tracked engines only, sampled on run days, never the whole of AI search: report the window and sample size and never claim causation. Reads stored results only. Takes a few seconds.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project": "<project>"
},
"name": "visibility_get_summary"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last day of the window as YYYY-MM-DD. Default today. | |
| from | No | First day of the window as YYYY-MM-DD. Default: lookbackDays before to. | |
| cited | No | true: only answers that cite a page of the brand. false: only answers that do not. | |
| pages | No | Only prompts whose answers cited one of these pages, then every engine for those prompts. Takes page URLs or bare domains such as "example.com", the brand's own or any other site, as returned in the citations section. | |
| topics | No | Only these topics, by the exact names from visibility_list_tracked. "Uncategorized" selects prompts with no topic. | |
| compare | No | true: also return totals for the window of the same length immediately before from. | |
| engines | No | Only these AI engines, by name from visibility_list_tracked, such as "ChatGPT" or "Perplexity". A plain name also matches its local-fetch variant. | |
| project | Yes | The Hi, Moose project, by its name as shown by list_projects. The projectId is also accepted. | |
| prompts | No | Only these prompts, by exact text or promptId from visibility_list_tracked. | |
| sections | No | Which sections to return. Default totals, engines and topics. | |
| compareTo | No | Last day of a custom comparison window, YYYY-MM-DD. Needs compareFrom. | |
| mentioned | No | true: only answers that mention the brand. false: only answers that do not. | |
| narrative | No | Only answers with this narrative verdict against the Brand Truth Profile: aligned, partial or drifted. | |
| sentiment | No | Only answers where the brand was mentioned with this sentiment. | |
| competitor | No | Only answers that mention this competitor, by name from visibility_list_tracked. | |
| promptType | No | Only branded prompts (the prompt names the brand, an alias or an owned domain) or only non-branded prompts. | |
| compareFrom | No | First day of a custom comparison window, YYYY-MM-DD. Needs compareTo. | |
| citedDomains | No | citations section: return exact counts for only these domains (and their subdomains) and the pages on them, however rarely they were cited. Unlike pages, this does not change which answers are counted. | |
| lookbackDays | No | Window length in days when from is not given. Default 30. | |
| minCitations | No | citations section: only domains and pages cited at least this many times in the window. | |
| citationsList | No | citations section: which list to return. Default both. Ask for domains or pages alone to fit more rows in one result. | |
| featureParity | No | Only answers with this feature parity verdict: accurate, needs-review, inaccurate or not-applicable. | |
| citationsLimit | No | citations section: how many rows of each list to return per call, most cited first. Default 50. Each row carries per-engine counts, so keep the rows in one result near 150 or fewer (for example 150 of one list, or 75 of both) and page with citationsOffset for more. | |
| citationsOffset | No | citations section: skip this many domains and pages, to page through the full lists. Pass the nextOffset of the previous call. Default 0. | |
| mergeEngineVariants | No | citations section: count the local-fetch variant of an engine under the engine's plain name in byEngine, so "ChatGPT (local fetch)" counts as "ChatGPT". Default true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| jobId | No | ||
| range | No | ||
| trend | No | ||
| status | No | done, failed, pending or running. | |
| totals | No | Counts over the answers in scope. Rates are fractions of answers (0 to 1) and null when there are none. unavailable answers are excluded from the rates. | |
| byTopic | No | ||
| filters | No | The filters that were applied, after validation. | |
| byEngine | No | ||
| byPrompt | No | ||
| headline | No | One sentence with the window, sample size and the main numbers. | |
| mentions | No | ||
| progress | No | ||
| runCount | No | ||
| sections | No | ||
| citations | No | ||
| createdAt | No | ||
| comparison | No | ||
| dataNotice | No | ||
| competitors | No | ||
| projectName | No | ||
| promptCount | No | ||
| byTopicEngine | No | ||
| schemaVersion | No | Version of this result shape. Fields are only added within a version. | |
| trendByEngine | No | ||
| byPromptTruncated | No | true when more than 300 prompts matched; filter by topic to see the rest. |