Compare brands
compare_brandsBrand Lookup's Competitor Research: a brand and 1 to 5 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. Estimated price: up to $0.44 for 5 competitors, up to $0.44 for 1: one AI mentions request per platform for every brand. A comparison saved within 24 hours, here or on the Brand Lookup page, is read free. It opens free on Brand Lookup; get_saved_brand_comparison reads it without buying. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
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": "compare_brands"
}
}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. | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| meta | No | ||
| query | No | ||
| saved | No | ||
| comparison | No | ||
| competitors | No | ||
| savedResultId | No |