List gaps
list_gapsLists the gaps of one brand: tracked prompts where AI answers did not cite, or rarely cited, the brand in the chosen period, most runs first. Each item has gap_class (absent: no citation and no mention; mentioned_not_cited: named but not cited; inconsistently_cited: cited in at most a third of at least three runs; not_visible_anywhere: absent with at least two runs), runs, cited_share (0 to 1), retrieval (per AI platform: runs that searched, runs that fetched a page of the brand domain, runs that cited it), top_competitor (most cited competitor page) and audit_status (none, running, ready, outdated). Get brand_id from list_brands. For an item with audit_status ready or outdated, call get_gap_audit with its prompt_id. The result carries the window used. Filters: topic_id, range (7d, 30d default, 90d), gap_class, limit (default 20, max 100) and offset. app_url opens this prompt's audit for this brand in SEOAI (the person signs in if needed).
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": {
"brand_id": "<brand_id>"
},
"name": "list_gaps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per page. Default 20, max 100. | |
| range | No | Period of runs to read. Default 30d. | |
| offset | No | Items to skip. Default 0. | |
| brand_id | Yes | Brand id from list_brands. | |
| topic_id | No | Only gaps of this topic (from list_brands). | |
| gap_class | No | Only this class. not_visible_anywhere is the subset of absent with at least two runs. |