Read a saved brand comparison
get_saved_brand_comparisonReads Brand Lookup's Competitor Research already bought for this project, however old, for free: a brand and its competitors side by side in AI answers (United States, English; ChatGPT and Google AI Overview), each one's mentions and AI search volume on each platform, and its Share of Voice. It never buys: what is not saved is named with the price compare_brands would pay for it.
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": {
"projectId": "<projectId>",
"query": "<query>",
"competitors": "<competitors>"
},
"name": "get_saved_brand_comparison"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| names | No | For a comparison of domains beside brand names, which compares every brand by name: the name to compare a domain by, keyed by the domain, e.g. {"bestbuy.com": "Best Buy"}. A domain left out is compared by the words it spells, capitalised ("Bestbuy", "Acme Shoes" for acme-shoes.com). Ignored when every brand is a domain. | |
| query | Yes | The brand or domain to compare, usually the project's own, e.g. 'example.com' or 'Example Brand'. | |
| scope | No | For a domain: the scope it is looked up with on Brand Lookup. Omit to derive it from the query, as the page does. The comparison itself always compares whole domains. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| competitors | Yes | 1 to 5 competitor brands or domains, in any order. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| query | No | ||
| saved | No | ||
| comparison | No | ||
| competitors | No |