Get search gaps
get_search_gapsCompares the brand's search demand with its AI visibility, from ONE source per call: Google Search Console (provider google, default) or Bing Webmaster (bing). The two are never added together. Returns connected (false: no property mapped for that provider, nothing else), stale (true: the connection needs renewing, data is the last sync), window (the search data period) and ai_window (the period of AI runs). search_only: queries with impressions but no tracked prompt. tracked_absent: queries covered by a gap prompt (see gap_class, cited_share, prompt_id, runs, competitor). gap_class has the same values as in list_gaps. ai_only: prompts cited in AI answers with almost no search demand. Each list holds at most the top 50 by impressions; counts has the totals. Take prompt_id to get_gap_audit (same prompts as list_gaps); brand_id, topic_id come from list_brands. Filters: provider, topic_id, range (7d, 30d default, 90d), limit (default 20, max 100), offset.
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": "get_search_gaps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per list and page. Default 20, max 100. | |
| range | No | Period of AI runs to read. Default 30d. | |
| offset | No | Items to skip per list. Default 0. | |
| brand_id | Yes | Brand id from list_brands. | |
| provider | No | Search data source, one per call. Default google. | |
| topic_id | No | Only tracked_absent and ai_only rows of this topic (from list_brands). |