Look up a brand
lookup_brandBuys a Brand Lookup for this project, as the Brand Lookup page does (United States, English; ChatGPT and Google AI Overview): how often AI answers mention a brand or domain and its AI search volume on each platform, and, when asked, the pages those answers cite and sample prompts, with Competitor Research against any competitors named. Estimated price: ~$0.44 for the mentions and AI search volume; cited pages ~$0.44 and sample prompts ~$0.80 more; Competitor Research ~$0.44 with 1 competitor, ~$0.44 with 5. What is saved and current, here or on the page, is read free; only the parts missing or out of date (after 24 hours) are bought, as the page's Refresh buys them. It opens free on Brand Lookup and in its History; get_saved_brand_lookup 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>"
},
"name": "lookup_brand"
}
}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. Ignored when every brand is a domain. | |
| query | Yes | The brand or domain to look up, e.g. 'example.com' or 'Example Brand'. | |
| scope | No | For a domain: the scope to look it 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. | |
| citedPages | No | Also buy the pages most cited in AI answers that mention it, when the lookup has none saved. Defaults to false. | |
| competitors | No | Up to 5 competitor brands or domains to compare it with (Competitor Research), in any order, bought with it as the page buys a lookup that names them. Omit for the lookup alone; compare_brands buys the comparison alone. | |
| samplePrompts | No | Also buy sample prompts whose AI answers mention it, with how often each is asked, when the lookup has none saved. Defaults to false. | |
| 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 | Yes | ||
| bought | Yes | ||
| lookup | Yes | ||
| competitors | Yes | ||
| savedResultId | No | ||
| accountRefusal | Yes |