AI visibility
visibility__overviewRead-onlyIdempotent
How often AI answers (ChatGPT, Perplexity, Gemini, Google AI) name this workspace's brand in the latest scan: the brand score, the brands named instead, the score per topic, the trend over the last scans, and every tracked prompt with its intent, tags, per-engine score and mention rate, least-mentioned first. The prompts at 0 are the gaps content can close; visibility__prompt shows why one is lost. The site-wide parts (overview, competitors, topics, history, scans_total, unanswered_prompts) come on the first page only; later pages carry the next prompts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows, 1-100 (default 20). | |
| offset | No | Rows to skip (default 0). Keep paging while has_more is true. | |
| workspace_id | Yes | From workspace__list. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | Yes | ||
| domain | Yes | ||
| topics | No | First page only. Per topic, weakest first: topic, prompts, mention_rate, previous_mention_rate (the scan before; null when none or not asked then), visibility_score. | |
| history | No | First page only. Last completed scans, oldest first: scan_id, finished_at, visibility_score, mention_rate (null while a scan is still extracting brands). | |
| prompts | Yes | Tracked prompts, least-mentioned first: prompt_id, topic, intent (informational|commercial|transactional|null), tags, text, mention_rate, previous_mention_rate (the scan before; null when none or not asked then), avg_position, per_model (model, score), brands_named. | |
| has_more | Yes | ||
| overview | No | First page only. visibility_score (0-100), mention_rate (% of answers naming the brand), avg_position, per_model. Null before the first scan. | |
| competitors | No | First page only. Brands the answers name in at least two answers, plus every competitor the user tracks (listed first, tracked: true): brand, domain, mention_rate, avg_position, visibility_score, tracked. | |
| scans_total | No | First page only. Completed scans of this site so far. | |
| workspace_id | Yes | ||
| scan_finished_at | No | ||
| unanswered_prompts | No | First page only. Prompts every engine failed to answer in this scan, so they have no rate: prompt_id, topic, text. visibility__prompt shows the errors. |