Get AI mentions gained and lost
get_ai_mention_changesBuys the AI mentions a brand or domain gained and lost for this project, as Brand Lookup does: month by month over the last year, how many ChatGPT and Google AI Overview answers started mentioning it, how many stopped, and the net change, in mentions and AI search volume, in the United States. Estimated price: ~$0.92 for both platforms. What is saved and current (for 24 hours), here or on the page, is read free, and only a platform missing or out of date is bought. It opens free on Brand Lookup. 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": "get_ai_mention_changes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The brand or domain, e.g. 'example.com' or 'Example Brand'. | |
| 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. | |
| 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 | ||
| bought | Yes | ||
| platforms | Yes | ||
| savedResultId | No | ||
| accountRefusal | Yes |