Get AI visibility results
seo_get_ai_visibility_resultsFor a normal review make one run-wide call with these top-level arguments (there is no filters object): runId null (or a manual run's runId), topic null, engines null, promptId null, cursor null, competitorGap false; never enumerate every engine or prompt. Use engines to request one or more engines in a single filtered call. Then read sources once for its returned runId and inspect 2-3 answer examples. Derive competitor gaps from returned rows or make a separate gap query; never carry competitorGap=true into overall source or branded-diagnostic reads. Read paginated prompt/engine observations and brand comparison counts over answered collections. Defaults to neutral prompts in the latest baseline/scheduled run, excluding manual checks unless the project has only manual checks; request branded=all to include branded diagnostics. Reuse the returned runId and filters for source analysis. No full answers or collection; use observation IDs with seo_get_ai_visibility_answer. Supports prompt history and competitor gaps.
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": {
"siteId": "<siteId>"
},
"name": "seo_get_ai_visibility_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| runId | No | Omit or null for the latest baseline/scheduled run, or the latest manual check when there is none. Reuse the returned runId for related source/answer reads. Do not use the string all. | |
| topic | No | Omit or null for all topics in the run. Filter by an exact saved topic name only when requested; do not use the string all. | |
| cursor | No | Omit or null for the first page. Use only a returned nextCursor for another page; do not use the string all. | |
| siteId | Yes | The Sextant site ID. | |
| branded | No | neutral | |
| engines | No | Omit or null for all engines in one call. Provide one or more engines for an explicitly requested subset, or an empty array for no engines. Do not make separate calls for each engine or use the string all. | |
| promptId | No | Omit or null for all prompts in the run. Provide an exact prompt ID only when requested; includeHistory returns that prompt's prior observations. Do not use the string all. | |
| competitorGap | No | Use false for the initial review, overall sources and branded diagnostics. True restricts rows to answers where a competitor appears and your brand is absent; an empty gap subset does not mean answer details are missing. | |
| includeHistory | No |