List brands
list_brandsLists the brands tracked in the connected SEOAI workspace, each with its topics (market, language, number of active prompts) and the number of open gaps over the last 30 days. Call this first: every other SEOAI tool needs a brand_id from here (and a topic_id from the topics list when you want to narrow to one topic). Next step: list_gaps with a brand_id, then get_gap_audit for a prompt that has an audit. A gap is a tracked prompt where AI answers did not cite, or rarely cited, the brand (counts come from stored runs). The window field gives the exact period behind open_gaps_30d. limit (default 20, max 100) and offset page through the brands; pagination.next_offset is null on the last page. app_url opens the brand in SEOAI.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_brands"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Brands per page. Default 20, max 100. | |
| offset | No | Brands to skip. Default 0. |