Read a saved brand lookup
get_saved_brand_lookupReads a Brand Lookup already bought for this project: how ChatGPT and Google's AI Overviews mention a brand or domain in the United States, and Share of Voice against the competitors it compared (get_saved_brand_comparison shows its Competitor Research). The pages they cite and sample prompts are bought on their own, so a lookup has them only when they were. Uses no credits and never buys: what is not saved or out of date is named with the price Brand Lookup asks for it, each of those two parts at its own. lookup_brand buys them at that price, as the page does, and compare_brands buys Competitor Research alone.
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>"
},
"name": "get_saved_brand_lookup"
}
}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, as it was looked up on the Brand Lookup page. | |
| scope | No | For a domain: the scope it was looked up with. Omit to derive it from the query, as the page does. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| competitors | No | The competitors its Share of Voice compared, if any, in any order. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| toBuy | Yes | ||
| lookup | Yes | ||
| addOnsToBuy | Yes | ||
| toBuyPriceUsd | Yes |